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This Library Memo announces the release uri'j yvjiiubiliiy v\ hit System 80 OS/3 Interactive Services Opera^ng Guide, 
UP-9972 Rev. 2. 

This guide is a standard library itenn (SLl). It is part of the standard library provided automatically with the purchase of the 
product. 

This guide describes the procedures used to communicate with the Unisys Operating System/3 (OS/3) interactively 
through a local workstation or remote terminal. It describes the dual-mode nature of the workstation, the messages the 
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job scheduling, and connect a workstation to a job. It describes tiie commands that conti-ol the job processing 
environment, control spooling, perform utility routines, and control workstation logging. 

For release 13.0, this guide documents support for the System 80 model 7E and enhancements to the PRINT, STATUS T, 
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About This Guide 



Purpose and Scope 



This guide is provided to help you use the interactive services of Unisys Operating 
System/3 (OS/3). It can serve as a reference manual, to be kept with your workstation 
for ready use. It can also help you familiarize yourself with the interactive commands^ 
the procedures for initializing the interactive services^ and using the workstation and 
interactive facilities such as the HELP function. 

Audience 

The intended audience is the system administrator and the workstation operator. 

How to Use This Guide 

Read the entire guide to familiarize yourself with the basic concepts it presents; then 
use it for reference as needed. 

Organization 

This guide is organized as follows: 

Section 1. Commuiiicating with Interactive Services and the System 

This section describes the two modes in which interactive services operate. It gives 
general information about the LOGON and LOGOFF commands and procedures, 
entering commands, and responding to messages at the workstation. 

Section 2, Running Jobs from the Workstation 

This section describes the procedures for running jobs from a workstation. It explains 
interactive job control, the commands used to schedule and run jobs from the 
workstation, the EXECUTE facility, and the concept of a master workstation. 
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Section 3. General Workstation Commands 

This section describes the commands used to control job execution, output spooling, 
and workstation logging from the workstation. 

Section 4. Utility Commands 

This section describes the commands for performing interactive utility routines^ 

Section 5« Quick-Reference Guide to the Interactive FaciMties^ Distributed 
Data Processing, BASIC, and ESCORT " 

This section provides reference information on the use of the interactive data utilities; 
the interactive dump/restore utility; the general and RPG 11 editors; the COBOL 
editor; the error file processor; screen format services; menu services; distributed data 
processing; and the interactive programming languages, BASIC and ESCORT. 

Appendix A» Interactive Terminals 

This appendix describes the different procedures used when accessing the OS/3 
interactive services from the local workstations, remote workstations, and all devices 
generated as terminals. It includes the standard terminal dialog of the Integrated 
Communications Access Method (ICAM) terminal support facility. 

Appendix B, Workstation Commands 

This appendix presents a quick reference to the interactive commands and their 
formats. 

Appendix C, Sample Workstation Sessions 

This appendix presents four sample workstation sessions, each showing the 
interactive commands being used to accomplish a t3rpical system task. 

Appendix D, Positional Format for File Parameters 

This appendix explains the use of the positional format to specify command file 
parameters. 

Appendix E. Function Key Summary 

This appendix lists the function keys used by the various interactive facilities. 
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Related Product loformation 

The following Unisys documents may be useful in understanding and implementing 
the OS/3 interactive services. 

Note. Use the version that applies to the software level in, use at your site. 

Job Control Programming Guide (7004 4623) 

This guide describes OS/3 job control and explains how to use it 

Spooling and Job Accounting Operating Guide (7004 4581) 

This guide describes, for the system administrator, basic spooling concepts, input and 
output spooling functions, remote spooling capabilities, and general spooling controls. 
This guide also explains how to initialize and recover the spool file, and how to 
produce job accounting reports. 

System Messages Reference Manual (7004 5190) 

This is a quick-reference manual that lists and describes the messages that can occur 
when using OS/3. 

Screen Format Services Technical Overview (UP-SS??) 

This overview describes how you can move information easily through your computer 
system, using the OS/3 screen format services. 

General Editor (EDT) Operating Guide (7004 4599) 

This guide describes the commands and procedures used with the OS/3 general editor. 

Report Program Generator II (RPG II) Editor OperuUom Guide (lJP-9981) 

This guide explains how an RPG II programmer can use the RPG II editor to create 
and maintain RPG 11 source programs interactively from a workstation. 

ESCORT Programming Language Programming Guide (1JP-8855) 

This guide describes how to write programs using the ESCORT programming 

language. 

COBOL Editor (COBEDT) Programming Guide (UP-9974) 

This guide explains how to interactively create and modify COBOL source programs. 

BASIC Programming Reference Manual (UP-9168) 

This manual describes how to write programs using BASIC. 
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Distributed Data Pretcessing Programming Guide (7004 4508) 

This guide describes distributed data processing and the corresponding products, 
including the DDP transfer facility and the DDP file access. 

Consolidated Data Management Programming Guide (UP-9978) 

This guide describes consolidated data management and how it moves data between 
peripheral devices and programs. 

Data Utilities Operating Guide (7004 4516) 

This guide explains how to execute data utilities interactively and as a batch job. 
Data utilities are used to reproduce and maintain data files on disks, diskettes, and 
tapes. 

Models 8-20 Installation Guide (7004 5505) 
Model 7E Installation Guide (7002 3858) 
Model 50 Installation Guide (7004 1892) . 

These guides provide the system administrator with the information and procedures 
to install, tailor, and maintain OS/3 software on the System 80 models 8-20^ 7E, and 
50 respectively. 

System Service Programs (SSP) Operating Guide (UP-8841) 

This guide describes the system service programs and explains how to use them. The 
system service programs are utility programs that support the operation and 
organization of the operating system, including the SAT and MIRAM librariajis, the 
linkage editor, disk, tape, and diskette prep routine, and various copy routines. 

Security Maintenance Utility Operations Guide (UP-12028) 

This guide describes how the system administrator can enforce system security by 
controlling access to the system's interactive services. 

Menu Services Technical Overview (UP-9317) 

This guide describes the OS/3 menus and explains how to use them with basic 
assembly language (BAL), COBOL, RPG II, and FORTRAN IV programs. 

Models 8-20 ICAM Operations Guide (7004 4557) 
Model 7E ICAM Operations Guide (7002 3908) 
Model 50 ICAM Operations Guide (7004 1967) 

These guides explain how to define an ICAM network, create a communications 
symbiont, and start up ICAM terminals in a models 8-20, model 7E, and model 50 
environment respectively. 
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Local Workstation - System 80 OperutorMefererwe CUP-8910) 

This guide provides an operational description ©f ttie workstation, 0797 and 0798 
printers, and magnetic stripe reader. It illustrates and describes controls and 
indicators for tiie workstation^ and describes the keyboard control keys. 

Universal Terminal Systems 400/4000 (UTS 400/4000) to OS/3 Interface User 
Guide/Programmer Reference (UP-8611) 

This manual explame how the experienced programmer can create programs to run on 
the UTS 400/4000. 

UmSCOPE Display Terminal Operator Re ference (UP-7788) 

TMs guide provides operating information for the UNISCOPE® 100 and 200 display 
terminals and the model 610 tape cassette. It lists and describes operator controls 
and indicators, keyboard control keys, and format keys. It also includes operating 
procedures for tiie tope cassette for read/write sequences, search, and other 
procedures. 

Universal Terminal ^atem 400 (UTS 400) Operator's Guide (UP-8358) 

This guide describes operator duties for using the UTS 400, including the operator 
controls for the keyboard and panel. It also describes screen displays in all 
applications, and how to use the tape cassette, diskette subsystem, printers, and 
magnetic stripe reader. 

Notation Conwentlons 

The conventions used to illustrate the commands presented in this guide are as 
follows: 

• Underscoring part of a command or parameter indicates tiiat you can abbreviate 
the command or parameter and enter only the underscored portion. However, you 
can enter the entire command or parameter and it will execute properly. When a 
command or parameter is not underscored, you must enter the entire command 
or parameter. In the following example, ER of the ERASE command is 
underscored. You must enter at least ER for the command to execute; but you 
can enter ERA, ERAS, or ERASE and the command will execute properly. 

ERASE 
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• Parameters printed in lowercase letters designate variables that you supply 
values for. 

VSN = volume 

• Parameters that are optional are enclosed in brackets. 

ERASE [WRPASS ^ wp] 

• Alternate choices for a parameter are enclosed in braces. 



ENTERADEVICE= 



rnnnl 
1 ^^^ J 



Note: Brackets and braces cannot be entered as part of the commands; they are 
used only to denote optional parameters and alternate parameter choices. 

Default values are values automatically generated by the system when you do not 
specify a value for a parameter. Default values are shown shaded in command 
formats. 



DISPLAYASPL 



■{1} 



You can enter commands and parameters in either uppercase or lowercase 
letters. The system accepts either uppercase or lowercase in all but a few special 
instances. When you are restricted to either uppercase or lowercase letters, a 
note informing you of this is included. 

Spaces are indicated by a delta (A) symbol. 
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Section 1 

Communicating with Interactive 

Services and the System 



1.1. Introduction 

The workstation is the principal means by which you and the system communicate. 
Using the workstation, you can perform almost every function available on the OS/3 
system. You can use the workstation to write a source program, compile and debug it, 
create a job control stream to run the program, and actually run the program. 
Through the workstation, you can also use the interactive facilities to make your data 
processing tasks easier and more efficient. 

The interactive commands are the means by which you use the workstation to perform 
various system tasks. Therefore, the bulk of this guide is concerned with describing 
the interactive commands. To help you understand how to use the various interactive 
commands to do real work on the system, Appendix C of this guide contains four 
sample workstation sessions, showing how the interactive commands work together to 
perform tasks. There are examples given with each interactive command to help you 
understand them. 

In this guide, you will encounter the term "workstation" a great deal. For purposes of 
this guide, we define a workstation as the terminal through which you use the OS/3 
interactive services. Appendix A lists all of the devices that can be used with 
interactive services. These are all used in essentially the same way to communicate 
with the system. The differences in their operation are covered in Appendix A. 

This section covers the procedures you use to communicate with the interactive 
services, and through them, the system in general. Included are procedures for 
logging on to the system, entering commands, responding to messages, and using the 
two operational modes of the workstation. Also included are procedures for attaching 
locally connected workstations to programs using the Integrated Communications 
Access Method (ICAM). One of these programs is the Unisys Information 
Management System (IMS). 

Note: If you use the Katakana character set, no lowercase-to-uppercase translation 

can be performed. 
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1.2. The Dyal-Mode Nature of the Workstation 

The workstation operates in two modes: 

• Workstation mode 

• System mode 

These two modes facilitate the use of the workstation as both a data transfer device 
for program input and output and as a control device to control processing. 

1.2.1. Workstation Mode 

Workstation mode makes the whole screen available to the user for data entry and 
output to user-created and system programs. To use workstation mode for data 
transfer, it must be connected to the pro-am requesting or suppl3ang the data. 
Connection is most often accomplished through job control (2.11). 

The CONNECT command is available to connect workstation mode to a job that does 
not automatically connect workstations through job control. System programs 
requiring workstation mode automatically connect the workstation mode of the 
workstation from which they are invoked. 

When data is output to your workstation by a program, enough data is output to fill 
your workstation screen. When the screen is full, the system tells the program to stop 
data output. Data output will not resume until you indicate that it should. There are 
different ways of resuming data output, depending on the type of terminal you are 
using as a workstation. Refer to Appendix A for detailed information on the use of 
each type of terminal. 

When workstation mode is not connected to a job, it serves to display commands 
entered at the workstation, as well as any output produced by those commands. See 
1.5 for a complete description of this aspect of the workstation mode function, 

1.2.2. System Mode 

System mode serves two functions. First, it is the mode used for entering unsolicited 
commands into the system. It is also the mode used for responding to system and 
program-generated messages. 

System mode uses two lines of the screen to display messages and accept responses. 
When you switch from workstation mode to system mode, any data on these two lines 
of the screen is saved in a buffer. The lines are cleared and system mode is able to use 
them. Messages are displayed on line 2 of the system input area. You enter message 
responses and unsolicited commands on line 1 of the system input area. 
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When workstation mode is not connected to a job, you must still enter system mode to 
enter commands and respond to messages. You still use line 1 of the system input 
area to enter commands (the cursor automatically positions itself at the first character 
position of line 1). However, the rest of the screen is available for the display of 
messages or command output. If a command produces a message requiring a 
response, you always enter your response on line 1 of the system input area. 

1.2.3. Switchiog between Modes 

You can switch between workstation and system modes to enter commands and 
respond to messages. The system can also prompt you to switch from workstation to 
system mode if it has a message waiting to be displayed to you. 

Since system mode requires the top two lines of the workstation display, when you 
switch from workstation mode to system mode, any data present on the top two lines 
of the screen is removed. The System 80 workstation and console workstation save 
the two lines of data, while the other terminals (the UNISCOPE 100 and 200 and UTS 
400) do not save the data removed by the mode switch. Therefore, if you are working 
with a terminal that does not save the data, be careful when you switch from 
workstation to system mode. The loss of the two lines of data could produce serious 
errors in some system and user programs. Consider waiting to acknowledge the 
message until you have finished with the contents of the screen. 

The following command moves the emulated system mode facility from the top two 
lines of the screen to the bottom two lines of the screen: 

SCREEM SI -BOTTOM 

The command to return the system input lines to the top of the screen (the default) is: 

SCREEM SI=TOP 

These commands do not take effect immediately, but only after the system mode is 
requested again. 

These commands allow the switching to system mode without causing an SF16 error 
because the top two lines are destroyed. An SF16 error can also occur if the cursor is 
transmitted from the bottom two lines of the screen, as SI=BOTTOM destroys the 
bottom two lines. 

When workstation mode is not connected to a job or system program, the workstation 
will automatically be switched back from system mode to workstation mode. This 
permits the use of the entire workstation screen for the display of command output. 

When workstation mode is connected to a job or system program, you must manually 
return to workstation mode after you have completed your tasks in system mode. The 
system does not permit you to return to workstation mode, however, if a message 
requiring a response has not been answered. 
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Each type of terminal has a different procedure for switching between modes. For 
information on the correct procedure for the terminal you use, see Appendix A. 



1 .3. Initializing the Workstation 



Before you can use either mode of the workstationj you must prepare it for operation. 
This involves entering the LOGON command. 

Every time you use the workstation, you must begin by entering the LOGON 
command. In addition, if 15 minutes elapses before you use Interactive Services, it 
automatically terminates and you must reenter the LOGON command. 

The LOGON command serves a variety of purposes. Through its parameters, you are 
identified to the system as a legitimate user, and the scope of your activities on the 
system is defined. 

When you enter the LOGON command, you have the following options. You can: 

® Display the logon bulletin 

The logon bulletin supplies you with information about the operation of your 
system. 

® Print a listing of the workstation log file at the end of your workstation session 

The workstation log file contains system messages, your responses, all of the 
commands you issued during your workstation session, and accounting records 
such as the amount of computer time you used. 

® Change your password 

The LOGON command is described in 1.3.2. You can also use the LOGON menu as 
described in 1.3.1. 



1.3.1. LOGON Meou 



When the workstation completes the power-on confidence test and requests that you 
log on, it is in workstation mode. To log on using the LOGON menu, press the XMIT 
key. The screen displays a menu listing the parameters of the LOGON command and 
providing spaces in which to enter the parameters. 

The system bulletin is displayed if you leave YES in the spaces following OPTIONS: 
BULLETIN. If you do not want to see the system bulletin, overwrite YES with NO. 
The log is printed if you leave YES in the spaces following LOG. In order to suppress 
the log, overwrite the YES with NO. Just enter the user-id, account number, and 
password assigned to you by your system administrator. 
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The system has automatically entered LOGON and is ready to receive the information 
supplied by the parameters you enter in the menu. When you have completed entry of 
your logon information, press XMIT again to send the logon information to the system. 
The logon menu looks like this: 



OS/3 IMTERACTIVE CONTROL SYSTEM 



LOGON IDENTIFICATIOHi 



OPTIOMS: 



USER- ID 


> 


< 


ACCOJMT NUMBER 




> < 


PASSWORD 


> 


< 


EXECUTION PROFILES 


> 


< 


BULLETIN 




>YES< 


LOG 




>YES< 


NEW PASSWORD 


> 


< 



The following screen shows the logon menu screen filled in with sample parameters: 



OS/3 IMTERACTIVE CONTROL SYSTEH 




LOGON IDENTIFICATION: USER- ID 


>ANDY < 


ACCOUNT NUHBER 


> < 


PASSWORD 


>0339 < 


EXECUTION PROFILES 


>PAYROLL < 


OPTIONSs BULLETIN 


>YES< 


LOG 


>YES< 


NEW PASSWORD 


> < 



Note^ The password is not visible when you log on at any of the following terminals: 
UTS 30, UTS 40, UTS 40D, UTS 400, PC, SVT 1120, SVT 1122, SVT 1123, 
SVT1124,BTOS. 

You can change the default values that appear on the screen for the BULLETIN and 
LOG logon parameters using the SET IS console command. 

Format 



SETAIS, 



BULLDEF 
BULLOVR 
WLOGDEF 

WLOGOVR 



■{l^} 
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The BULLDEF parameter lets you specify whether YES or NO appears as the default 
on the logon screen for the bulletin queiy. The WLOGDEF lets you specify the default 
for the log queiy. These are also valid for a usei* who logs on in batch mode or does a 
smart logon from system mode. 

The BULLOVR parameter lets you specify wheliier or not the interactive services user 
logging on can change the value on the bulletin query that appears as a default. The 
WLOGOVR parameter lets you specify whether the user can change the default value 
on the log query. If it is set to NO, the user cannot change the value. If the user tries 
to change it, the following message is displayed: 



IS 136 USER NOT ALLOWED TO CHANGE BULLET I M AND/OR LOG VALUES 

The user is still logged on (if there are no other logon errors). These parameters also 
apply to batch logons and smart logons. 

1.3.2. The LOGON Command 

In order to log on using the LOGON command, the workstation must be in system 
mode. In system mode, enter the LOGON command and press the XMIT key. 

The following is the format of the LOGON command: 

fnO I ,LOG= J MO 1 

1 Hi I I iii I 



LOGOMAuser- id[ ,acct] C , password] C ^exec-pro] 



.BULLETIN- 



[ ,MEWPASS-new-password] 

Parameters 

user- id 

Is a 1- to 6-character alphanumeric code you enter to identify yourself to the 
system. The user-id is used by the system to correctly route messages and 
job and command output, and to determine which commands you may use on 
the system. The user-id must begin with an alphabetic character. 

acct 

Is a 1- to 4-character alphanumeric code that is used for system time 
accounting. 

password 

Is a 1- to 8-character alphanumeric code that controls your access to the 
overall system. 
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exec -pro 

Specifies an execution profile attached to your u.ser-id. Execution profiles 
are a series of commands that are automatically executed by the system 
when you log on under a particular user-id. A typical use of an execution 
profile would be to go directly from LOGON to the general editor. Each user 
profile can have a default execution profile, which is invoked if none is 
specified with the LOGON command. The default can also be no execution 
profile. A user-id may have any number of different execution profiles, but 
the system must know them as legitimate for the user-id.. The system 
administrator controls which execution profiles may be invoked by different 
user-ids. To specify an execution profile, you enter the name assigned to the 
execution profile. In the sample menu screen in l.S.l, the execution profile 
is named PAYROLL. 

BULLET I M= r m 1 

i HSlj 
Specifies whether or not you want to see the system bulletin after your 
LOGON command is accepted. The system bulletin is a display of one or 
more lines detailing current operational information, such as hours of 
operation, or peripherals in or out of service. The default (YES) can be 
changed using a SYSGEN parameter and a SET command. 

LOG= 




ies whether or not you want the log of workstation commands and 
messages printed when you conclude your workstation session. See 3.4 for 
more information on workstation logging. Accounting records are included 
at the end of the workstation log file. Therefore, if you suppress printing of 
the log file, you also suppress printing of the accounting records. (Interactive 
accounting is discussed in detail in 1 ,9.) The default can be changed using a 
SYSGEN parameter and a SET command. 

MEWPASS=neM- password 

Specifies the new logon password (1- to 8-character alphanumeric code) that 
you must use for all subsequent logons. This parameter lets you change the 
logon password without having the security administrator do it for you. 
When the new password is transmitted, it replaces the existing password in , 
your user profile. 



Notes: 



If you enter the LOGON command and you omit one of the first four 
positional parameters, you must enter a comma for that parameter. For 
example, if you enter LOGON with a user-id and password but no 
account number, you would enter it like this: 

LOGOM USERA„ SECRET 
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You do not need to enter additional commas between the last positional 
parameter you enter and the first keyword parameter. The system can 
discern keyword parameters from the positional parameters preceding it. 

2. You cannot continue the LOGON command on a second line. If you need 
more than 60 characters, use the logon menu instead. 

Example 

LOGON BILLP, 4789, BULLETI^=MO, LOG-MO 

In this example, a user has logged on with the user-id BILLP and the account number 
4789. The system bulletin is not displayed because BULLETIN=NO is specified. The 
workstation log won't be printed at the end of the workstation session because 
LOG=NO is specified. 

1 .3.3. Reentering LOGON 

If your LOGON command or screen is not accepted, interactive services displays: 

IS23 INVALID FORMAT FOR THE LOGON COMMAND, REENTER LOGON 

The incorrect LOGON command remains on the first line of the workstation screen if 
it is rejected. The following conditions could cause this command or screen to be 
rejected: 

• Incorrect Sjoitax 

The command was misspelled or ambiguous, or the command parameters were 
entered improperly. 

® Insufficient Resources 

The system does not have sufficient resources available to support another 
interactive user. 

® Nonunique User-id 

Another user is already logged on the system with the user-id you entered in your 
LOGON command. Each user must have a unique user-id. 

To reenter LOGON, press the XMIT (or TRANSMIT) key for the menu screen or shift 
to system mode and reenter the LOGON command. 
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1 3 A. The LOGON ACCEPTED Display 

When your LOGON command or screen is processed and accepted by the system, a 
display rolls up from the bottom of the screen, informing you that your LOGON is 
accepted. If you specified the system bulletin, it is displayed here. The following is a 
typical LOGON ACCEPTED display: 







OS/3 


INTERACTIVE 


SERVICES 
















71 


LOGOH003 


LOGOM 


ACCEPTED AT 


12:45:39 


ON 


80/01/28 


. REV. 


13 


.0 




72 
73 


LOGON003 
LOGOH@03 


TODAY 


S BULLETIN 


IS? 














k-k 








U*l 


k**-k*!i 










74 
75 


LOGON003 
LOGON003 


* SYSTEM WILL BE 


AVAILABLE 


FRCW 09 


00 


TO 17: 


00 


TODAY 


■^ 





















If your site administrator does not provide a bulletin, the system displays the default 
bulletin. The default bulletin contains instructions for entering commands to the 
system. The following display shows the default bulletin. 



72 LOGON083 


IS27 


TODAYS BULLETIN IS; 


73 LOGON003 




-■ TO TYPE IM COMMANDS, DEPRESS 'FU?^CTIOM« AMD -- 


74 LOGON0@3 




■- 'SYSTEM MODE' KEYS SIMULTANEOUSLY, THEN TYPE -■ 


75 LOGON003 




-- THE COMMAND AND DEPRESS TRANSMIT, 


76 LOGON003 




-- ON UNISCOPES DEPRESS 'MESSAGE WAITING' KEY. -- 



1.4. System-Supplied Menus 



After your LOGON command is accepted, your workstation displays a menu 
requesting that you select a system function. This is the first of a series of menus 
supplied by Unisys to help you relate to and use the interactive facilities of OS/3. 

The menus allow you to select the system function you need. Through help displays, 
they assist you in understanding the different system functions. 

The Unisys standard menus are displayed to you after logging on, provided the 
MENU command is present in your execution profile. If the menus are not displayed, 
you can see them by entering: 

MENU 
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SYSTEM MEHU: 08301 
2. PERFORM A SYSTEM FUNCTION 



3. END iEMU 

4. LOGOFF 



FOR HiLP ON A PARTICULAR ITEM MUMBER, EUTER A QUESTIOM MARK 
FOLLOyED BY THE ITEM NUMBER am. HELP FOR THE EMTIRE DISPLAY 
CAM BE ACQUIRED BY ENTERING A QUESTIOM MARKC?) THEM PRESSING 
TRANSMIT » 

ENTER SELECTIOM; 2 



Making certain selections on this menu causes other menus to be displayed, giving you 
further choices of system facilities. For example, selecting item 2, PERFORM A 
SYSTEM FUNCTION, on the pre¥ious menu screen, causes the following menu to be 
displayed. 





SYSTEM FUMCTIOM 


MEMUs OS314 






1 


* DATA UTILITIES 




7.* 


EDITOR 




2 


* BASIC 




8. 


JCL DIALOG 




3 


* SCREEM FORMAT GEMERATOR 




9. 


SYSGEM DIALOG 




4 


* MEMU OEMERATOR 




10. 


HARDVARE UTILITIES CMU) 


5 


* RPG EDIT 




11. 


RETURM TO SYSTEM 


MEMU 


6 


* ESCORT 










•k 


OPTIOMAL SOFTWARE. CONTACT 


YOIR 


UMISYS MARKETING OFFICE 
EMTER SELECTION ?2 





If you don't understand a selection on a menu, you can call for a help screen to explain 
the function. For example, entering the question mark and number 2 in the ENTER 
SELECTION field of the previous screen requests an explanation of the BASIC 
interactive programming language. The following screen is thereby displayed: 



BASIC (THE BEGIMMER^S ALL PURPOSE SYMBOLIC INSTRUCTION CODE) 
COMPILER PROVIDES INSTRUCTIONAL SUPPORT AHD PROBLEM- SOLVING 
CAPABILITIES WITH AN EASILY LEARNED LANGUAGE, BASIC PROVIDES 
THE CAPABILITIES OF GENERATING, MODIFYING, SAVING, AMD EXECUTING 
PROGRAMS. BASIC SUPPORTS ADVANCED LANGUAGE FEATURES SUCH AS 
FILES, SUBPROGRAMS, STRING HANDLING, CHAINING, USER-DEFINED 
FUNCTIONS ETC. THE PROCESS OF PROGRAM ENTRY IS INTERACTIVE; THE 
WORKSTATION USER IS NOTIFIED OF ANY SYNTAX ERRORS AS THE 
STATEMENTS ARE ENTERED » 

PRESS TRANSMIT CONTINUE. 

0S314E 



140 
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Some menu selections provide multiple help screens. When you have finished with the first 
screen or when you want to return to the menu, just press the TRANSMIT key. 

Note: You can also create your own menus through menu services. (See 5.2 for a 
brief overview of menu services.) To call user-created menus, see the MENU 
command (4.14). 

1 3. Entering Commands at the Workstation 

You can enter commands only when the workstation is in system mode. When you 
enter system mode, the cursor is repositioned at the first character position of the first 
line. You enter commands on this line or the bottom of the screen (see 1.2.3). 

If workstation mode is connected to a job or system program, any output generated by 
commands is displayed on the -second line of the workstation, the system message line. 
Output is displayed one line at a time. You must press the XMIT (TRANSMIT) key 
after each line is displayed to see the next line of the display. 

When workstation mode is rmt connected to a job or system program, entering 
commands requires a slightly different procedure. You can still enter commands only 
when the workstation is in system mode. However, after you have entered a 
command, the system switches back into workstation mode and uses the entire screen 
to display command output. The command you entered on the first line is redisplayed 
{echoed) on the bottom line of the screen. Output fi*om a command rolls up from the 
bottom line of the screen. If the output is longer than the screen capacity, the system , 
continues to roll up the output, and the first lines of output are rolled off the second 
line of the screen and lost. If this happens, you can stop the output by switching to 
system mode and viewing the output one line at a time. If you remain in workstation 
mode to view the output, you must return to system mode before you can enter 
another command. 

If a command is unacceptable, the system responds with an error message informing 
you why Ae command is unacceptable. This message can be either aNAK (negative 
acknowledgment) message or a prefixed message. NAK messages appear in the last 
14 character positions of the system message line. The up-to-12-character message is 
bracketed by blink characters (A A). Prefixed error messages and NAK messages can 
be found, with explanations of their meaning and actions to be taken, in the System 
Messages Reference Manual (7004 51 90). 

You can control and display the status of the jobs running under your user-id. If you 
have been given global status privileges by the system administrator, you can display 
the status of a/l jobs currently running on the system. For more information, see the 
Security Maintenance Utility Operations Guide (UP~12028), 
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1 .6. Messages at the Workstation 



Messages are generated by commands, system programs, and users for the purpose of 
user-system and user-program communication. Messages are divided into three 
categories. The first is output messages, which are produced by the system, system 
programs, commands^ or user programs. These messages provide you with 
information, direct you to take some action, or ask a question requiring your response. 
The second is solicited input messages. These are messages you enter in response to 
an output message requiriog a response. The third category is unsolicited input 
messages. These are messages you enter that are not in response to an output 
message. 

The message "Continue? Workstation Screen Full." is generated only when requested. 
The following occurs when the MSG WAIT indicator is lit while you are listing an EDT 
module: 

• If you press MSG WAIT, the terminal switches to system mode and displays the 
waiting message. 

• If you press a function key to continue or terminate the listing, the continuation 
message is not displayed. 



1.6 J. Output Messages 

Output messages are displayed on the second (system message) line of the 
workstotion. They are in the following format: 



J jobnww 1 

■| syf*font-fd J 



■text 



where: 



Is a 2-digit message-id. Message-ids are consecutively assigned to output 
messages. They begin with the number 11 and end with 99. Once the 
system reaches message 99, the count begins over again starting with 11. 
Message-ids are used together with a jobname or symbiont-id to explicitly 
identify each message in the system. When an output message requires a 
reply, you must prefix your answer with the message's message-id. 



Identifies an output message that must be answered before the job, 
command, or system program that issued the message can continue. If the 
workstation mode of your workstation is connected to a job, and you have 
switched to system mode to receive messages, you cannot return to 
workstation mode until all messages requiring responses have been 
answered. 



H2 
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A 

Identifies an output message tliat requires no reply or action. It is displayed 
for your information only. Input messages, solicited and unsolicited, must 
have a space between the message-id and the message text. 



Identifies an output message that requires some action be taken. Execution 
pauses for the job that produced the message. You must issue a GO 
command to reactivate the job (see 3.2.6). 

Is the name of the job sending you the message. It can be from 1 to 8 
characters long. 

syntjfont-id 

Identifies which symbiont is sending you a message. The symbiont-id is six 
characters long. The first two characters identify the actual symbiont 
sending the message. The next four characters are the task number. The 
system assigns task numbers to uniquely identify each task the symbiont is 
performing. 

message- text 

Identifies the actual message content. Message texts can be a maximum of 
120 characters. If the message is longer than 120 characters (as in some 
messages generated by the COBOL and RPG II compilers), the message is 
truncated. 

Note: If the message is prefixed with a C, it is a system console message. 

1 .6.2. Solicited Input Messages 

Solicited input messages are messages you enter in response to an output message 
requiring a reply (question mark immediately follows message-id). The format for 
solicited input messages is: 

nnAmessage-text 

where: 

nn 

Is the message-id of the message you're responding to. 

message- text 

Is the actual text of the reply. 

Note: If the message is prefixed with a C, it is a system console message. 
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1 .6.3. Unsolicited Input Messages 

Unsolicited input messages are those messages you. enter that are not in response to 
an output message requiring a reply. The format for unsolicited messages is as 
follows: 



00Asymbiont-id 
00Asymbiont-1dCdid) 
00Asymbiont- 
UMSAjobname 



Amessage text 



where: 

00 
UNS 



Specifies that the unsolicited message is for a symbionl 



Specifies that the unsolicited message is for a user job. 

symbiont-ld 

Is the 2"Character symbiont id used to call the symbiont receiving the 
message. For example, PR is the S3niibiont-id for the output writer. 

symbiont-idCdid) 

Is the 2-character symbiont-id plus the channel address for the device used 
or controlled by a specifie copy of the symbiont in main storage. For 
example, PR(160) is the symbiont identification of the output writer using 
the printer at device address 160. 

symbiont-name 

Is the actual 8-character name of the symbiont receiving the message. For 
example, SL$$OW00 is the symbiont name of the output writer. 

jobname 

Is the name of the user job receiving the unsolicited message. 

message- text 

Is the actual text of the message. It can be up to 80 characters long. 

Note: If you are using the workstation for data entry and you change modes to 

respond to a message, be sure the last screen of data you are working with is 
transmitted to the system. The audible alarm sounds once when the XMIT key 
is pressed and data transfer is not successful. 
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1£A. Restoring Response Messages {REBUILD Command) 

During your use of the workstation, especially in workstation mode, you can 
inadvertently clear the screen while there is an outstanding message requiring a 
response. A command is available to restore messages requiring a response or a GO 
command to the screen. The REBUILD command erases your screen and reconstructs 
any outstanding response messages in the system for your workstation. 

Format 

REBUILD 

There are no parameters associated with this command. 

If you have lost a message, or think you have lost a response message, key in RE. 
Your workstation screen clears, and any outstanding response messages are 
redisplayed to you. 

1.7. Connecting Local Workstations to ICAM 
User Programs 

Some of the system programs of the OS/3 operating system interface with users 
through terminals connected by the Integrated Commimications Access Method 
(ICAM). One of these system programs is the Information Management System 
(IMS). You can access such ICAM-connected programs from a directly connected 
(local) workstation by logging on, entering system mode, and issuing the standard 
ICAM terminal sign-on command, $$SON. When you have finished with the program, 
enter system mode and issue the ICAM terminal sign-ofF command, $$SOFF. For 
complete information on the ICAM sign-on and sign-off commands, see Appendix A. 

1.8. The LOGOFF Command 

When you have finished all the tasks you want to do with the system and are ready to 
end your workstation session, enter the LOGOFF command. Ifyou enter LOGOFF 
while one of the interactive facilities (such as the general editor) is running, the 
LOGOFF command is rejected. 

Ifyou enter this command from a terminal connected through ICAM, your session will 

be ended and another user can log on. You must enter the ICAM sign-off command 
($$SOFF) before the terminal will be released. See Appendix A for information on the 
ICAM sign-off command. 
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Any programs you initiated that are running and that do not require the workstotion 
for input or output purposes will continue to rmij with messages directed to the 
system console. 

Fonnat ■ 

LOGOFF 

There are no parameters associated with this command. It cannot be abbreviated. 
The following conditions can cause this command to be rejected: 

• Functions Still in Use 

You cannot log off the workstation if an interactive services function you called 
from the workstation is still running. 

• Workstation Is Reserved 

The workstation is either allocated or reserved for a job. 

• Unanswered Messages 

You have not answered all the messages requiring a response sent to your 
workstation. 

• Incorrect Syntax 

The command was misspelled or not entered in its entirety, or the command was 
entered with parameters appended. 

If your LOGOFF command is not accepted by the system, the following message is 
displayed: 

23 LOGOF005 IS74 LOGOFF IGNORED, WORKSTATION IS STILL IN USE 

When your LOGOFF command is accepted by the system, the following message is 
displayed: 

32 LOGOF005 IS73 LOGOFF ACCEPTED AT _'._:__0n _/_/_ 

The blank spaces show the time (hh:mm:ss) and date (yy/mm/dd) of lo^ng off. 

In addition, after your logoff is accepted, a listing of the workstation log file for your 
workstation session is printed (unless you specified LOG=N when you logged on or 
unless you generated your system without workstation losing through the SYSGEN 
parameter, CONSOLOG). Refer to 1.3.1 for more information. 
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Your workstation log automatically shows all the commands you entered while in 
system mode. If you want your log to include commands entered both in system and 
workstation mode (EDT commands, for example), you can specify that with the LOG 
parameter of the SCREEN command (3.2.8). 

The OS/3 ...PLEASE LOGON screen display appears again until the workstation is 
shut off or signed off from ICAM, or until another user logs on. 



1 J. Interactiwe Accounting 



Accounting information is maintained for every workstation session. When you log 
off, this information is summarized and added to the end of your workstation log file. 
These accounting records appear as the last four messages on the workstation log file 
listing you get when you log off. (If you specified LOG=N when you logged on, you do 
not get a listing of account records, although the system still accumulates the records. 
See 1.3.1.) 

Accounting records list such things as CPU time used, the number of files used, and 
the number of commands issued. Here is a sample accounting listing: 



>LOGOFF 

12 LOGOF008 IS73 LOGOFF ACCEPTED AT @9;@4;40 ON 89/05/11 
AC50 USER-ID=ISJLS2 ACCT IIO=IS00 LOGON AT 08:55:36.462 LOGOFF AT 09:04:41,114 CONNECT TIHE 00:09:04.652 
AC51 CPU TIME USED=0@: 00: 04.738 TASK PRIORITY=01 DATE=89/@5/11 NUHBER OF EXCP' 8=00001169 
AC52 NUMBER OF: COHMANDS=00011 FILES ACCESSED=00007 SVC CALLS=00001497 TRAMSIEHT CALLS=00000055 
AC53 DEVICE EXCP'S 3A2=00001129 TRM=0@0000@2 294=00000038 
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Running Jobs from the Workstation 



2.1. Introduction 



TMs section describes the method you use to nm jobs from the workstation. A job can 
be either a series of programs you have created, or an interactive facility supplied by 
Unisys. A job occupies a job slot, and is scheduled and executed by either the RUN/RV 
or SC/SI commands. 

The first step in running a job on OS/3 is the creation of a job control stream. The job 
control stream carries information to the system about the job, such as which files are 
used by the job. You can create job control streams interactively by using the job 
control dialog. 

When you have created your job control stream, it can be stored on the job control 
stream libraiy file ($Y$JCS) or an alternate file that you designate. You can also 
store job control streams or job control procedures (jprocs) on $Y$JCS or an alternate 
file by using the FILE command, discussed later in this section. 

To run yoiir job, the system must first read the job control stream you created for the 
job. After it has read the job control stream it must expand any jprocs in the job 
control stream. Ajproc is a series of job control statements, represented in a job 
control stream by a single statement. When ajproc is expanded, the single statement 
is replaced by the series of statements it represents. The system then schedules your 
job for execution so that all the system resources it needs will be available to it and 
finally executes it. This entire process is handled by the RUN/RV and SC/SI command 
processors. 

When your job control stream is read, your job is scheduled for execution by being 
placed on a job scheduling queue, where it waits its turn for system resources. There 
are four job scheduling queues available for use based on the priority of your job. They 
are preemptive for jobs that must run immediately, high for jobs that must run as soon 
as possible, normal for jobs that can run whenever the necessaiy system resources are 
available and low for jobs that run only when the other queues are empty. These 
priorities are discussed in more depth in connection with the RUN and SI commands. 
While your job is waiting in a scheduling queue for execution, you can change its 
scheduling queue. You can defer it from being scheduled for execution, reinstate it in 
a scheduling queue for execution, or remove it entirely from the scheduling queue. 
You can also produce a display of the contents of the four job queues to check on the 
progress of your job through the queue. The BEGIN, HOLD, DISPLAY, DELETE, and 
CHANGE commands explained in 2.10.1 through 2.10.5 allow you to perform these 
functions. 
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2.2. The Job Control Dialog 



You use the job control dialog to interactively build job control streams. Through. 
menu screen displays, you are offered choices of statements needed to create a job 
control stream. The system prompts you through eveiy step of creating a job control 
stream, tailored to the specific needs of your job. 

You initialize the job control dialog by entering the RV command with tiie jobname 
JC$BLD: 

RVAJC$BLD 

When you enter this command, your workstation screen clears^ and a display appears 
introducing the job control dialog: 



PROGRAM^ 



DIALOG FOR JOB CONTROL 



THIS DIALOG PREPARES A JOB CONTROL STREAH OR PROCEDURE CJPROC). FOR AH 
EXPLAMATION OF THE DIALOG PROCESS, EMTER 'HELP" 11^ THE SPACE PROVIDED. 



If you choose to go on, and do not require an explanation of the dialog process, another 
screen is displayed, the actual beginning of the job control dialog: 



JOB CONTROL MODULE TYPES: 

USE THIS MEMO TO SELECT THE TYPE OF MODULE TO BE PREPARED i 

1. JOB CONTROL STREAM 

2. USER WRITTEM JOB COMTROL PROCEDURE (JPROC) 

3. HELP 

SELECT ITEM BY EMTERI^JG A NUH8ERA 
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If you need an explanation of the types of modules to be prepared, enter the number 3 
in the space provided, as shown in the preceding illustration. Entering HELP will 
cause the following two screens to be displayed, explaining what a job control stream 
and JPROC are: 



IM ORDER TO EXECUTE ANY JOB, .IT IS NECESSARY TO CONVEY TO THE CWPUTER EXACTLY 
yHAT YOJ WANT TO DO, AND WHAT RESOJRCES (PRINTER, READER, DISKS, ETC) ARE 
HEEDED. THIS IS ACCWPLISHED THROJGH THE USE OF JOB CONTROL. THERE ARE TWO 
TYPES OF JOB CONTROL MODULES. THE COLLECTION OF JOB CONTROL STATEMENTS USED TO 
RUN A JOB IS CALLED A JOB COMTROL STREAM, SWETIMES REFERRED TO AS THE JOB 
STREAM OR COiTROL STREAM, IM IT, THERE MAY BE JOB COiTROL STATEMEiTS, CALLS TO 
SYSTEM SUPPLIED PROCEDURES, AMD THE SECOND TYPE OF MODULE - USER -WRITTEN 
PROCEDURES (JPROCS). 

PUSH TRANSMIT KEY TO PROCEED 



JOB COiTROL PROCEDURES HAVE TW PARTS - THE DEFINITION AND THE CALL» THE 
DEFINITION IS THE JPROC MODULE CREATED BY THE DIALOG. THE CALL IS A STATEMENT 
IN THE COMTROL STREAM WHICH HAS THE JPROC MAME AS THE CWMAND, AND PROVIDES ANY 
NECESSARY PARAMETERS. THE JPROC CALL IS USED AS AN ABBREVIATION TO PREVENT 
CODING THE DEFIMITIOi MANY TIMES. WHEN THE COMTROL STREAM IS PROCESSED, EACH 
CALL IS REPLACED BY THE APPROPRIATE DEFINITION UHICH HAS BEEN PUT AT THE 
BEGINNING OF THE STREAM OR STORED !M A SYSTEM FILE C$YSJCS>. THE RESULT IS THE 
SAME AS IF THE DEFIMITIOM HAD BEEN CODED IMSTEAD OF THE CALL. 

PUSH TRANSMIT KEY TO PROCEED 



The dialog continues as you enter information, make choices from menus, and receive 
help as you need it. When, you have completed a job control stream, it is stored in the 
job control stream file, $Y$JCS, or an alternate file you can specify. 

Note: This section is written to give you an overview of job control and building job 
control streams interactively. For detailed information, refer to the Job 
Control Language Programming Guide (7004 4623). 
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2 J. Filing Job Control Streams fFILE Command) 

The FILE command files jobs and jprocs read from an input de¥ice to the permanent 
job control stream libraiy file ($YWCS) or to an alternate SAT library file. 

FoEmat 



ULE 



J <Wid],latel) 1 A 
I (RDR, label) J 







1 


ait-fUenaiK Ij 


(ait-f iiena!». 


RES 
RUN ■ 


) 




vsn 


. 


(alt-f ilenaiK, 


' RES ■ 
RUN • 


^ write -pass) 




vsn 


J 






J J 



Parameters 



([did], label) 

Specifies a diskette volume from which the job control stream or jproc is 
read, did is a 3-digit hardware address that specifies the drive on which the 
diskette is mounted. The first digit is the channel number; the second and 
third digits are the actual hardware address, did is usually physically 
displayed on the device it represents, label specifies the name of the diskette 
data set containing the Job control stream or jproc that is being filed. The 
diskette must have been recorded in data set label mode. The record size 
must be 128 bytes or less. The records must be unblocked and unspanned. 
This parameter must be enclosed in parentheses. 

Note: For more detailed information on di4 refer to the software 
Installation Guide for your system. 

(RDR, label) 

Specifies that the job control stream or jproc you want to store is located in a 
subfile of the input spool file. RDR specifies that the job control stream or 
jproc is located on the input spool file, label specifies the name of the subfile 
containing the job control stream or jproc. This parameter must be enclosed 
in parentheses. 

Note: A file in the reader queue can be accessed only once. So once you 

execute the file command, you can no longer access the file from the 
reader queue. 
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ialt"fUen«» 

Specifies tiie name ©f tiie alternate file, residing on the SYSRES disk, that 
is to receiYe the job control stream or jproc. The alternate file must have 
been allocated as a SAT file. If ihe alternate file is cataloged, you need only 
enter tiie name of the alternate file; tiie volume serial number for the file 
found in tiie catalog is used. You specify only the name of the file if no 
password is needed to write to tiie file. If you do not specify an alternate 
file, file job control stream or jproc will be filed in $Y$JCS. 



i(alt-fil« 



RES 



Specifies the name of the alternate file and identifies a volume serial 
number for tiie file. The alternate file must have been allocated as a SAT 
file. The alternate library file can reside on either a disk, or a diskette 
recorded in format label mode. If you want the alternate file to reside oi> 
the SYSRES disk, specify BBS. If you want the alternate file t© reside on 
the $Y$RUN disk, specify RUN. If you want the file to reside on another 
volume, specify the volume serial number for the volume. The volume serial 
number can be from one to six charactere long. If another file with the same 
file name is in the catalog, tiie volume serial number you enter with ttie 
command distinguishes between the two files and overrides tiie catalog 
volume serial number. There must not be a password for the alternate file 
specified in the catalog. 



:Calt-fll« 



RES 



^write-pass) 



Specifies tiie name of the alternate file, a volume serial number if needed or 
wanted, and a password, identified in &e catalog, required to write to the 
alternate file. The alternate file must have been allocated as a SAT file. 
The volume serial number is specified as before. If you do not enter a 
volume serial number, the one listed in the catalog will be used. 

Note^ You cannot use the FILE command to access an actual card reader. 
You can use spooled readers only. 
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Examples 

FILEC320,MYJOB) 

This command files a job control stream named MYJOB to $Y$JCS on SYSRES. The 
stream is stored on a diskette mounted on the device whose channel and address are 
320. When the file command has successfully filed the stream, the user sees this 
message: 

JC26 MYJOB FILED ON REL082 IN $Y$JCS 

In this example, the volume serial number of the SYSRES disk is REL082. 

FILEC321, MYJOB) :CMYFILE,RES) 

This command files a job control stream named MYJOB to an alternate file named 
MYFILE on SYSRES. The stream is stored on a diskette whose channel and address 
are 320, When the file command has successfully filed the stream, the user sees this 
message: 

JC26 MYJOB FILED OU REL082 lU MYFILE 

In this example, the volume serial number of the SYSRES disk is REL082. 

FILE(RDR,HYJ0B2) 

This command files a job control stream named MYJ0B2 to $Y$JCS on SYSRES. 
This stream is stored on the reader queue in the input spool file. When the file 
command has successfully filed the stream, the user sees this message: 

JC26 MYJ0B2 FILED OM REL082 IN $Y$JCS 

In this example, the volume serial number of the SYSRES disk is REL082. 
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2.4. Running Jobs {RUN^¥ Commands) 

The RUNM¥ commands cause the job control stream associated with your job to be 
read and expanded^ and your job to be scheduled for execution. The RUN command 
reads job control streams from the $Y$JCS library file, an alternate job control libraiy 
file, a data set label diskette, or the input spool file. You, use the RUN command when 
the job requires card-image input, either from a data set label diskette or the input 
spool file. The RV command reads job control streams only from the $Y$JCS file or an 
alternate job control library file, and is used when no card-image input is required. 
You cannot specify an input device in tiie RV command. 

Notes: 

1. When you use the RUN command with a data set label diskette as input device, 
make sure, prior to entering the command, that the diskette you need is mounted on 
a diskette drive. 

2. You cannot use the RUN command to run a job requiring the use of an actual card 
reader; you can only use spooled readers. 

The RV command is used when no input device is required. 
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Fo^aiat 



RUM 



J ([did], label) 1 A [. 
I (RDR, label) J 



RVAj 



[(new 



)] 



lECnew- 



J)3 



:alt-filef 
:(alt-fil« 



;<alt-fil 



:alt-fUer 
:(alt~fU« 



;(alt-fil« 



RES 
RUN 
vsn 

RES 
RUN 
vsn 



, read-pass) 





■ PRE 




+ 


■ d1 1 




HIGH 


[.tiriK] 




: 




. LOW 






. d9 J 



[ , key- 1=val - 1 , . . . skey-n=val -n] 




J read-pass) 



t 


' PRE 




+ 


■ d1 1 


' 


HIGH 


[.time] 


• 


: 




. t» 






. * J 



[,key-1=val-1j ...,key-n=vai-n] 



PaiaMieters 



([did], label) 

Specifies a diskette volume from which the job control stream and 
replacement embedded data can be read, did specifies the device address of 
the diskette drive on which the diskette is moumted. label specifies the name 
of the diskette volume containing the embedded data. The diskette must 
have been recorded in data set label mode. The record size must be 128 
b3/tes or less. The records must be unblocked and unspanned. This 
parameter must be enclosed in parentheses. 

Note: For more detailed information on did, refer to the software 
Installation Guide for your system. 
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CRDR, label) 

Specifies that the replacement embedded date is located on a subfile of the 
input spool file. RDR specifies that &e data is located on the spool file. 
label specifies the name ©f tiie subfile containing the data. This parameter 
must be enclosed in parentheses. 

jobianw 

Specifies tiie name of the job to be read from either $Y$JCS or the alternate 
JCS file specified. The jobname is required if no input device (diskette or 
spool file) is specified to contain the job control stream you want to run. 



Cnew-naue) 

Specifies a new name for a job already stored under the job name. The job is 
read from $Y$JCS (or alternate) under the job name and is placed on a job 
queue and scheduled for execution under its new name. The job name and 
new name can be from one to eight alphanumeric characters long. The new 
name must be enclosed in parentheses. 



Specifies tiie name of the alternate file, residing on SYSBES, that contains 
tiie j©b» If the alternate file has been cataloged, tiie vsn identified for that 
file in the catalog is used. In this case, the catalog does not contain a 
password for the file, so you do not need to enter one witii the command. 



:(alt-f!l 



RES 
vsn 



Specifies the name of the alternate file containing the job and identifies a 
volume serial number (MES, RUN, or vsn) for the file. The alternate file can 
reside on ei&er a disk, or a diskette recorded in format label mode. If the 
alternate file resides on SYSRES, specify i^SiS. If it resides on $Y$RUN, 
spedfy iJC/M. If it resides on another volume, enter the serial number of 
tiiat volume. If another file witii the same file name is in tiie catalog, the 
volume serial number you enter with tiie command distinguishes between 
the two files and overrides the catalog volume serial number. There must 
not be a password for the alternate file in the catalog. This command must 
include parentheses. 



;Calt-fil 



RES 
RUN 

vsn 



, read-pass) 



Specifies the name of the alternate file containing the job, a volume serial 
number if needed or wanted, and a password, identified in the catalog, 
required to read from the file. The volume serial number is specified as 
before. If you do not enter a volume serial number, the one listed in the 
catalog will be used. This parameter must include parentheses. 
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PRE 
HIGH 



LOW 

Specifies tlie scheduling priority of your job. PRE specifies that the job 
should ran at preemptive priority, the highest priority available. Preemptive 
jobs, in order to obtain sufficient main storage for execution, can cause other, 
lower priority jobs to be rolled out (on systems with roUin/rollout configured). 
You should never schedule a job with preemptive priority without first 
consulting the system administrator. HIGH specifies that the job should run 
at high priority. High priority jobs will be scheduled for execution before 
jobs of lower priority, but will not be scheduled until any preemptive jobs are 
scheduled. NOR specifies that the job should be run at normal priority. 
Normal priority jobs run only when there are no jobs left in either the 
preemptive or high priority queues. Normal priority is used for most jobs. 
LOW specifies a low priority. Low priority jobs run only when no other jobs 
are left on any other queue in a non-HOLD state. If you do not specify a 
scheduling priority, the priority indicated in the // JOB statement of the job 
control stream is used. If no priority was specified in the // JOB statement, 
normal priority is assigned by default, 

time 

Specifies the time of day to start execution of your job. The start time is 
military time. The job execution begins as soon as the resources are 
available after the time specified. 

d1 through d9 

Specifies a future day for the start of the job (up to ten days from the 
specified date) in increments of one day, 1 through 9, added to the time 
specified in the time parameter. 

key- 1=val - 1 , . . . ,key-n=val -n 

Specifies a series of keywords to be used by the job you want to run. The 
keywords and their values must be supplied by the person creating or 
running the job. 

Note: The total length of all parameters specified in this command can be no 
longer than 60 characters. 

Examples 

RUC320,INFILE) OURJOB: (J0BFILE,MYV0L1) 

In this example, replacement embedded data for the job named OURJOB is read from 
the diskette mounted on device 320. INFILE is the name of the diskette file that 
contains the embedded data. The job itself (OURJOB) resides on an alternate file 
called JOBFILE, which is located on a disk volume called MYVOLl. The job runs at 
normal priority. 
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RUCRDR.MYFILE) MYJOB,H 

In this example, replacement embedded data for the job named MYJOB (which 
resides in the $Y$JCS file) is read from the input spool file (specified by RDR). 
MYFILE is the name of the subfile (or label) located on the input spool file. The job 
runs at high priority. 

RV MYJOB-.CJOBFILE,REL082,SECRET) 

In this example, the job named MYJOB is run fi-om the file named JOBFILE, located 
on the volume that has the volume serial number of REL082. SECRET is the 
password required to read the file. The job runs at normal priority. 

RV PAY JOB, L 

In this example, the job PAYJOB is run at low priority. Since no input device or 
alternate file was specified, the job control stream for PAYJOB resides on $Y$JCS, the 
system job control stream file. 

RV JOBPAY,L2230+1 

In this example, the job named JOBPAY is run at low priority starting after 10:30 
p.m. tomorrow. 

The following conditions can cause this command to be rejected: 

® Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 

® File Not Found 

The system cannot find the file on which the job you want is located. 
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2.5. Prerun Job Execution 

The job control procedure (jproc) calls are actually a series of job control stotements 
that perform a specific function. Before a Jproc can be used by flie system as part of 
the Job control stream, it must be expanded, or changed from a single statement into 
all the statements that single statement represents.- The expansion process is one of ■ 
the most time-consuming steps in tiie job execution process. However, using two job 
control option statements, you can save job control streams in the expanded state, 
cutting down the time needed to run those jobs in the future. The two option 
statements are // OPTION SAVE and // OPTION NOSCHED. The SAVE option 
inserted in a job control stream enables the job to be run when a RUN command is 
entered, and it saves the job control stream after it is expanded. The NOSCHED 
option only expands tiie Job control stream and saves it, without scheduling the job for 
execution. 

Expanded Job control streams are saved in the $Y$SAVE hbraiy file or an alternate 
MIRAM libraiy file. It is important to note tiiat they are not stored in a statement-by- 
statement format. The job control streams are translated into code recognizable only 
to the nm processor. Therefore, you cannot make changes to a saved job control 
stream stored in the $Y$SAVE file. Note also, if tiie main storage requirements of a 
saved job increase, tiie Job must be saved again. 

23. 1 e The SI/SC Commands 

The SI/SC commands initiate the reading of a job control stream from tiie $Y$SAVE 
libraiy file (where it has been saved in its expanded state) and then sdiedule the job 
for execution. 

The SI command is used to initiate the reading of a job control stream that requires 
the use of an input device, either a diskette or spool file, to replace data embedded in 
the job control stream. When you use the SI command with a diskette as input device, 
be sure, prior to entering the command, that the diskette you need is mounted. The 
SC command is used when no input device is required. 

Note: You cannot use the SI command to run a job requiring the use of an actual 
card reader; you can only use spooled readers. 
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PRE 
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[time] 



dl 
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Paia^eters 



([did], label) 

Specifies a diskette volume from which replacement embedded data is read. 
did specifies the device address of the diskette drive on which the diskette is 
mounted, label specifies the name of the diskette volume contaimng the 
embedded data. The diskette must have been recorded in data set label 
mode. The record size must be 128 bytes or less. The records must be 
unblocked and unspanned. This parameter must be enclosed in parentheses. 

Note: For more detailed information on did, refer to the software 
Installation Guide for your system. 

(RDR, label) 

specifies that the replacement embedded data is located on a subfile of the 
input spool file. RDR specifies that the data is located on the spool file, label 
specifies the name of the subfile containing the data. This parameter must 
be enclosed in parentheses. 



Specifies the name of the job read from $Y$SAVE and scheduled for 
execution. 
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(r»W"nai») 

specifies a new name for a job already stored under the job name. The job is 
read from $Y$SAVE or alternate MIRAM libraiy under the job name and is 
placed on a job queue and scheduled for execution under its new name» The 
job name and new name can be from one to eight alphanumeric characters 
long. The new name must be enclosed in parentheses. 



:alt-ffi< 

Specifies tiie name of tiie alternate MffiAM file, residing on SYSEES, tiiat 
contains the job. If the alternate file has been cataloged, flie mn identified 
for tfiat file in ttie catalog is iised. In this case, tiie catalog does not contain 
a read password for tiie file, so you do not need to enter one wifli tiie 
command. 



:(alt-ffli 



RES 
RUM 



Specifies the name of tiie alternate MIKAM file containing the job and 
identifies a volume serial ni^ber (BES, RUN, or mn) for the file. Hie 
alternate MIRAM file can reside eittier on a disk or on a diskette recorded in 
format label mode. If flie alternate file resides on SYSKES, specify BES. ff 
it resides on SYSRUN^ specify RUN. If it resides on another volume, enter 
tiie serial number of that volume. If another file witii ttie same file name is 
in tfie catalog, ttie volume serial number yon enter witii tiie command 
distinguishes between the two files and overrides ttie catalog Yoluine serial 
number. There must not be a read password for ttie alternate file in the 
catalog« This command must inclu^ pareMtwms. 



:<alt-fflj 



RES 
RUM 



^ read -pass) 



Specifies the name of tfie alternate MIEAM file containing the Job, a volume 
serial number if needed or wanted, and a password, identified in the catalog, 
required to read from the file. The volume serial number is specified as 
before. If you do not enter a volume serial number, &e one listed in the 
catalog is used. This parameter must include pareMhems, 
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PRE 

iH" 

Specifies the scheduling priority of your job. PRE specifies that the job 
should run at preemptive priority, the highest priority available. Preemptive 
jobSj in order to obtain sufficient main storage for execution, might cause 
other, lower priority jobs to be rolled out (on systems with rollin/rollout 
configured). You should never schedule a Job with preemptive priority 
■ without first consulting the system administrator. HIGH specifies that jobs 
should run at high priority. High priority jobs are scheduled for execution 
before jobs of lower priority, but are not scheduled until any preemptive jobs 
are scheduled. 

NOR specifies that the job should run at normal priority. Normal priority 
jobs run only when there are no jobs left in either the preemptive or high 
priority queues. Normal priority is used for most jobs. LOW specifies a low 
priority. Low priority jobs run only when no other jobs are left on any other 
queue. If you do not specify a scheduling priority, the priority indicated in 
tiie // JOB statement of the job control stream is used. If no priority was 
specified in the //JOB statement, normal priority is assigned by default. 

time 

Specifies the time of day to start execution of your job. The start time is 
military time. The job execution begins as soon as the resources are 
available after the time specified. 

dl tiiroughct9 

Specifies a future day for the start of the job (up to ten days from the 
specified date) in increments of one day, 1 tiirough 9, added te the time 
specified in tiie time parameter. 

£xamplcs 

SIC321,M¥FILE) PAYJOBsCPAYFILE,JOBVOL) 

In this example, embedded data from file MYFILE is read in from a diskette mounted 
on device 321. The saved job using the embedded data is called PAYJOB. PAYJOB is 
located on the MIRAM file called PAYFILE, which resides on a volume called 
JOBVOL. PAYJOB runs at normal priority. 

SC MY JOB, H 

In this example, the job named MYJOB was saved in its expanded state. It is run by 
entering the SC command because there is no embedded data in the job control stream 
to be replaced. It is scheduled as a high priority job. 
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SC JOBPAY,L2380+5 

In this example, the job named JOBPAY was saved in $Y$SAVE library using the 
NOSCHED job control option. As no data input device is required, it is run by calling 
the SC command. The job will run at low priority after 2300 hours military time in 
five days. 

The following conditions could cause this command to be rejected: 

• Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 

• File Not Found 

The job file cannot be found. 



2.6. The EXECUTE Facility 



EXECUTE is an interactive facility designed to save you response time if you run 
more than one workstation-oriented job in a single workstation session. 

Whenever you initiate a job, it does not begin executing immediately. First, the run 
processor scans your control stream to translate job control statements and to expand 
jprocs. Then it checks for order and sjmtax errors. If your control stream is error free, 
the run processor builds a table of control blocks that describe your job requirements. 
Next, it creates a file for yo-ur job on $Y$RUN. 

When the run processor is finished, the job scheduler function is activated. It reserves 
devices and main storage for your job as they become available. It then selects your 
job for execution according to its priority when the devices and main storage needed to 
run it are available. Each time you run a job, the run processor and job scheduling 
steps are repeated. 

The EXECUTE facility, however, allows you to run a set of programs without going 
through the run processor and job scheduling steps for each program. It does this by 
enabling you to define a single job control stream for a set of programs of your 
choosing. This job control stream is called a super-set job control stream. When you 
run the super-set job control stream, it creates an interactive job environment. All a 
workstation operator has to do is select a program from the super set and issue an 
EXECUTE command. Since the job environment has already been established, the 
program is loaded and executed without any wait for job control processing. 
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2.6.1. Choosing Jobs to Ry n Interacti¥ely 

Before building a super-set job control stream, yen must select the programs you will 
execute in an interactive job environment. When choosing programs^ consider these 
points: 

• Choose programs that use the workstation. Examples are programs that use 
screen format services or menu services. 

• Do not choose programs that call for embedded data (// PAEAM statements or 
/$.../* sequences). They will not work. EXECUTE is designed only for programs 
that interactively ask you for information. 

• Do not choose programs that are run in batch mode. 

2.6.2. Building the Super-Set Job Control Stream 

The super-set job control stream is based on the job control streams and resource 
requirements for each program you've selected for your super-set. The resources you 
must take into consideration are: 

® Main storage 

® Peripheral assignments 

® Workstation assignments 

The following steps outline the basic job control requirements needed to build a super- 
set job control stream. 

Step Is 

The first statement you build is the jobname statement: 

// JOB S$&USER$„main storage requirement 

The name $$&USER$ is the jobname the EXECUTE facility expects to find. You can 
specify your own jobname but when you run your super-set job control stream, you 
must rename it to $$&USER$. (The RV and SC commands have a new-name 
parameter where you would specify $$&USER$.) It is easier to keep $$&USER$ as 
the jobname and then, if necessaiy, write the super-set control stream to a file under 
another name. 

The jobname statement must also allocate enough main storage to run the largest 
program in your super-set, (You can need to consult a link map for the size of your 
user programs.) 
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You can insert any // OPTION statements you want to include after the // JOB 
statement. 

Step 2: 

A single workstation file definition is required. It must be of the form: 

// DVC 200 // LFD Ifd-name 

You can define only one workstation file. Therefore, a single Ifd-name must be agreed 
upon for all programs in your super-set job control stream. This can mean recompiling 
your programs to use the agreed-upon Ifd-name. A // UID must not be specified. 
Multiple Ifd's for this file are also not permitted. A // LBL statement is allowed, but 
serves no purpose in this context. 

Step 3j 

You must allocate peripherals (printer, punch, diskette, disk, and tape devices). For 
easier construction, you should group all file definitions for like volume names 
together. DVC numbers may need to be resolved so that they reflect the correct 
volume names; for example, you should construct your statements so that DVC 50 
always refers to volume X, DVC 51 refers to volume Y, and so forth. 

The DVCVOL jproc should be used with care. If you run the super-set job control 
stream using the RV command, then any jproc processing could add to initiation time. 
On the other hand, if you run your super-set job control stream using the SC 
command, then jprocs have no adverse effect on initiation time. 

If one or more programs use a different logical name for the same file, the file can be 
assigned more than one LFD name. For example: 

® 

// DVC 50 // VOL INVTRY 

// LBL INVENTORY // LFD IMVILE 

// DVC 50 // VOL INVTRY 

// LBL INVENTORY // LFD INVEMTY 

Note: Devices allocated to a super-set job remain allocated for the duration of the 
user session. 

Step 4: 

All programs in your super-set must reside on the same libraiy file. Thus, you may 
need to copy your programs to a common library. You must define this library in your 
super-set job control stream. In addition, the Ifd-name for this file must be placed on 
the // EXEC statement for the super-set job control stream. If your common library is 
the $Y$LOD library, it isn't necessary to define the file. 
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The // EXEC statement executes a system-supplied program that actually creates the 
interactive job environment. The statement is: 



// EXEC $$INT,lfd- 

where the Ifd-name is the library where your programs reside. The super-set job 
control stream does not reference any job but $$INT, which resides on $Y$LOD. Thus, 
no special handling is required for $$INT. 

You. end the super-set job control stream with the following statements: 

/& 

// FIM (for card input only) 

StepSj , 

You must file the super-set job control stream on disk. You can do this with tiie FILE 
command or EDT. Once it's on disk, you can run it with the RV command. For 
additional speed, you can save the job by including a // OPTION SAVE,NOSCHED 
statement in your super-set control stream. Once a job is saved, it can run with the 
SC command. 

2.6.3. Using the EXECUTE Command 

To begin an interactive job session, you must run the super-set job control stream. 
Using the RV command, you enter: 

RV jobname 

where jofinoTOe is the name of the module in which your super-set job control stream 
resides. If your super-set job control stream was saved in the expanded form (via the 
// OPTION SAVE/NOSCHED statement), you can run it with the SC command: 

SC jobnan?e 

If you used any name other than $$&USER$ on the // JOB statement, you must 
rename the job on the RV or SC command: 

RV JobnameCS$&USER$) 
SC jobname<$$&USER$) 

(Note that you can include the RUN statement for your super-set job control stream in 
a user's execution profile. This way, when the user logs on, the super-set job control 
stream is automatically initiated.) 
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Once your super-set job control stream is processed, the job (or interactive job 
environment) that is created has the name 

$$userid 

in the system, where userid is the user-id under which you logged on. This enables a 
single super-set job control stream to be used simultaneously at different 
workstations. Each time the super-set job control stream is nm, a new interactive job 
environment is established with a different user-id. 

With the interactive job environment ready, you can issue requests to execute 
programs: 

EXECUTE progran-nane 

where program-name is the 1- to 6-character name from the // EXEC statement of one 
of the user programs in your super-set. The program is loaded into the job region and 
is given control. When the program terminates (either normally or abnormally), you 
receive the message: 

IS 126 EXECUTE COMMAND TERM I MATED 

You can issue only one EXECUTE command at a time. That is, you must wait for one 
pro-am to finish before you can initiate another one. You can, however, issue as 
many EXECUTE commands in the course of a single session as you'd like. Dumps 
requested via the // OPTION statement are produced as usual, if the program 
terminates abnormally. Any spooled output is also printed when the EXECUTE 
command has terminated. 

When an EXECUTE command terminates, the job region remains available and you 
can issue another EXECUTE command. You can also use other workstation 
commands, such as COPY, EDT, RUN, or CONNECT, between EXECUTE commands. 

To end the interactive job environment, you simply log off. If you want to use the 
CANCEL command, you must remember that, when an EXECUTE command is active 
(a program is nmning), you must first cancel the program that is running and then 
cancel the interactive job environment. If you use the CANCEL command when an 
EXECUTE command is not active, the complete job environment is cancelled. When 
cancelling the job environment, remember that the jobname is always $$userid, not 
$$INT. 
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2£A, Creating and Ronning a Sample Syper-Set 
Job Control Stream 

Suppose there are three programs that you. consistently run in a single workstation 
session. These programs are an RPG II program that processes faetoiy shipments, 
another RPG 11 program that updates the factory's vendor information, and a COBOL 
program that controls invoicing. In order to achieve faster response times, you want 
to create an interactive job environment for these three programs by using the 
EXECUTE facility. Figure 2-1 lists the job control streams for all three programs. 



RPG II SHPMNT 
PROCESSING PROGRAM 



RPG II VEMDOR 

UPDATE PROCESSING PROGRAM 



COBOL 

IMVOICIMG PROGRAM 



// JOB SHIPMENT,, 4000 

// DVC 20 // LFD PRNTR 

// DVC 200 // LFD WKSTH 

// DVC 50 // VOL IMVTRY 

// LBL IMVEMTORY // LFD lUV 

// DVC 50 // VOL INVTRY 

// LBL BACKORDER // LFD BKORD 

// DVC 51 // VOL PRQGRM ' 

// LBL LOADLIB // LFD LOAD 

// EXEC SHPHNT^LOAD 

/& 

// FIN 



// JOB VNDRyPDT,,A000 
// DVC 20 // LFD PRf^TR 
// DVC 200 //LFD WKST^ 

// DVC 50 // VOL invmY 

// LBL INVEMTORY // LFD im 
// DVC 50 // VOL lUVmY 
II LBL VEMDORS // LFD VEND 
// DVC 51 // VOL PROGRM 
// LBL LOADLIB // LFD LOAD 
// EXEC VENDOR, LOAD 
/& 
// FIM 



// FIM 

// JOB IMVOICE,,7800 

// DVC 20 // LFD PRNTR 

// DVC 200 // LFD WORKSTAT 

// DVC 50 // VOL IMVTRY 

// LBL IMVENTORY // LFD INVFILE 

// DVC 51 // VOL ACCTNG 

// LBL BILLS // LFD CUST8ILL 

// DVC 52 // VOL PROGRM 

// LBL LOADLIB // LFD LOAD 

// EXEC INVOIC,LOAD 

/& 

// FIM 



Figure 2-L Sample Programs 

On the // JOB statement, you use the jobname $$&USER$ and you evaluate the main 
storage requirements of the programs in your super-set. The largest of the three 
programs is the program VENDOR. Its main storage requirement is AOOO. Thus, the 
finished // JOB statement is: 

// JOB $S&USER$, ,A@00 

In addition, you want a job dump in case an error arises when you run the program. 
You include a // OPTION statement following the // JOB statement: 

// OPTION JOBDUMP 

Next, a workstation file assignment must be developed. Programs SHPMNT and 
VENDOR use an Ifd-name of WKSTN, while INVOIC uses WORKSTAT, In order to 
include INVOIC in the super-set, the program must be recompiled with the common 
ifd-name WKSTN. Once this is done, you can use the super-set workstation device 
assignment: 

// DVC 200 // LFD WKSTN 
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Now you must make device assignments. You define a printer with a common 
lfd~name and make a series of disk assignments. You decide that DVC 50 refers to 
INVNTY, DVC 51 to ACCTNG, and DVC 52 to PROGRM. Since duplicate definitions 
are permitted using the same Ifd-name for all files except the workstation, you can 
construct the device assignment sets as: 

// DVC 20 // LFD PRHTR 

// DVC 50 // VOL INVTRY 

// LBL INVENTORY // LFD INVFILE 

// DVC 50 // VOL INVTRY 

// LBL INVENTORY // LFD II^V 

// DVC 50 // INVTRY 

// LBL BACKORDER // LFD BKORD 

// DVC 50 // VOL INVTRY 

// LBL VEMDORS // LFD VEMD 

// DVC 51 // VOL ACCTNG 

// LBL BILLS // LFD CUSTBILL 

// DVC 52 // VOL PROGRAM 

// LBL LOADLIB // LFD LOAD 

Since all three programs already reside in the same library, it isn't necessary to copy 
them to a common libraiy. The last three statements needed to complete the super- 
set job control stream are: 

// EXEC S$IMT,LOAD 

/& 

// FIH 

Figure 2-2 shows you the completed super-set job control stream. 

Once constructed^ you now write the job control stream either to the $Y$JCS library 
file or to an alternate libraiy file. You can perform the write function through EDT or 
the FILE command. For this example, the super-set control stream is written to a 
module called BILLINGl on the file MYFILE, which resides on disk volume 
MYVOLl. 
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// JOB $$&USER$„A08e 

// OPTION JOBDUMP 

// DVC 20 // LFD PRUTR 

// DVC 50 // VOL IMVTRY 

// LBL INVENTORY // LFD IMVFILE 

// DVC 50 // VOL IMVTRY 

// LBL INVENTORY // LFD IMV 

// DVC 50 // VOL IMVTRY 

// LBL BACKORDER // LFD BKORD 

// DVC 50 // VOL IMVTRY 

// LBL VENDORS // LFD VEND 

// DVC 51 // VOL ACCTNG 

// LBL BILLS // LFD CUSTBILL 

// DVC 52 // VOL PROGRH 

// LBL LOADLIB // LFD LOAD 

// DVC 200 // LFD WKSTN 

// EXEC $SIHT,L0AD 

/& 

// FII^ 



Figyre 2-2. Completed Super»Set Job Control Stream 
Later, when you are ready to run the super-set job control stream, you log ©n: 

LOGOM AMDY 

You then enter the run command: 

RV BILLIMG1;CHYFILE,HYV0L1) 

When the system has processed your super-set job, the interactive job environment is 
created under the name: 

$$AHDY 

where ANDY is your user-id. At this point, you can enter an EXECUTE command to 
run one of the programs in your super-set: 

EX VENDOR 

When program VENDOR terminates, the message 

IS126 EXECUTE COMMAMD TERMINATED 

is displayed on your workstation screen. You can now enter another EXECUTE 
command: 

EX SHPMNT 
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When youVe run the necessaiy programs from your super-set, you end the interactive 
job environment by simply logging off: 

LOGOFF 

If you're not ready to log off, however, you can cancel the interactive job environment 
by issuing the CANCEL command: 

CAMCEL $$ANDY 

Note that you can cancel $$ANDY only if an EXECUTE command is not active. If an 
E3ffiCUTE command is active, you miist first cancel the program that is running and 
then cancel the job environment. For example: 

First command: ca vendor, m 

Second command: ca $$amdy,m 



2£3, Error Messages 



The following are error messages that could be displayed at your workstation in the 
event of a problem: 

® IS 124 NO LOAD MODULE NAME SPECIFIED 

An EXECUTE command was entered without a program name, A one- to six- 
character program name must follow the command verb, separated by a space. 

® IS78 EXECUTE COMMAND STILL ACTIVE, WAIT FOR IT TO FINISH 

You must wait for one EXECUTE command to finish before issuing another. 

® IS 127 LOAD MODULE MAME TOO LOMG 

The program name specified on the command is longer than six characters. 
Consult the link map for the correct program name. 

® IS128 EXECUTE COMMAND MOT ALLOWED MOW, W/S STILL lU USE 

You cannot execute a program while ttie workstation is being used by another job 
or interactive utility. The workstation may have been connected (via the 
CONNECT command) to a job, or a command such as EDT or BASIC can be 
active. 
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IS129 EXECUTE CCWHAMD EMCOUMTERED ERROR CODE XX 



A system error was encountered while trying to load your program. See the 
system messages manual for a full explanation. The most common error codes 
are 51 (program not found or spelled incorrectly) and 5B (insufficient main 
storage to run program). 

® IS31 INVALID OPTION FOR EXECUTE COHMAMD 

The only parameter permitted on the EXECUTE command is the program name. 
Additional parameters entered after the program name cause this error. 

If you try to use the EXECUTE command before the job environment has been 
established, an automatic DISPLAY JS command is issued by the system. This 
command tells you why the job environment is not ready. For example, the super-set 
job could still be imder control of the run processor or there isn't enough main storage 
for it to run yet. Remember, the super-set job control stream is constrained by the 
same resource limitations as any other job; for example, main storage, job slots, and 
CPU utilization. 



2J. Downline Loading. Programs fDLOAD) 



The DLOAD command allows a UTS 400 terminal user or a UTS 40/40D workstation 
user to downline load a program to terminal storage (memory). It is specifically 
designed for users of the PL/M and COBOL compilers and the BMC80 assembler. Any 
program you load with the DLOAD command must reside in the $Y$LOD library. 

Downline loading is the process by which you load a program designed to execute on a 
UTS 400 terminal or on a UTS 40/40D workstation "down a communications line" to a 
terminal from a host processor. Aside from using the DLOAD command, downline 
loading can also be done using an ICAM communications user program (CUP). You 
can also load a program offline, or manually, from an auxiliary device. If you're 
manually loading from an auxiliary device, you must have previously downline loaded 
your program from your host processor to your auxihary device, such as a diskette. 
The UTS 40014000 to OS/3 Interface User Guide / Programmer Reference (UP.8611) 
describes both downline loading through ICAM and offline loading from an auxiliary ■ 
device. 

Note,' The DLOAD command does not support loading to diskette from the host. As 
a result, segmented COBOL programs cannot be loaded to the diskette with 
this command. This can only be done using an ICAM communications user 
program (CUP). 
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Fonnat 

DLOADA J progran-name 1 
I /OFFLINE J 

where: 

program -name 

Specifies the program, residing in $Y$LOD, that you want to downline load. 
This form of the DLOAD command allocates all of the aimliary devices your 
system needs to downline load tiie program and then loads it. During the 
time your system loads and executes your program, DLOAD has sole control 
of those auxiliary devices, and you cannot run any other program that uses 
them. Also, you cannot successfully issue ASK or TELL commands during 
the time your system loads and executes your program. If issued, these 
commands are sent to the system console. (See 3.2.1 and 3.2.10 for 
information about the ASK and TELL commands, respectively.) As the 
loading takes place, the message LOAD IN PROGRESS is displayed. After 
your program terminates, you must enter the UNLOAD command (2.8) to 
free the devices for other uses. 

/OFFLINE 

Allocates all of the auxiliaiy devices needed for offline, or manually, loading 
a program from an auxiliaiy device. Therefore, you must enter 
DLOADa/OFFLINE before you offline load the program. Once you receive 
the message READY TO LOAD, AUXILIARY DEVICES ARE ALLOCATED, 
you can manually load the program. See the UTS 400 j 4000 to OS 1 3 
Interface User Guide I Programmer Reference (UP-8611) for information on 
offline loading programs. Once your program terminates, remem^ber to enter 
the UNLOAD command to free the auxiliaiy devices for other uses. 

Example 

DLOAD MYPR0G1 

In this example, you are downline loading the program MYPROGl to terminal storage 
(memoiy). 

The following conditions could cause this command to be rejected: 

• Wrong Device 



The DLOAD command can be initiated only from a UTS 400 terminal or a UTS 
40/40D workstation. 

Incorrect Syntax 

The command was misspelled or ambiguous, or the command was entered 
improperly. 
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The following are error messages associated with the DLOAD command: 
® Errors unique to DLOAD signifying an internal problem 

15107 MEMORY START ADDRESSES NOT EQUAL IN DOWN-LINE LOAD 

15109 ILLEGAL CONTROL CODE FOUND IN DOWN-LINE LOAD 

• Other errors unique to DLOAD 

15108 MEMORY ADDRESS OUT OF RANGE FOR DOWN-LINE LOAD 

15110 DOWN-LINE LOAD NOT DIRECTED TO A MASTER WORKSTATION 

15111 TERMINAL REJECTED DOWN-LINE LOAD, HAY NOT BE PROGRAMMABLE 
IS133 AUXILIARY DEVICES ARE NOT AVAILABLE 

2.8. Freeing Auxiliary De¥ices (UNLOAD) 

The UNLOAD command frees devices that were allocated to a downline-loaded 
program. To downline load a program to a UTS 400 terminal or UTS 40/40D 
workstation, you use the DLOAD command (2,7). When your system loads and 
executes your program, DLOAD has sole control of those auxiliaiy devices your 
program requires and you cannot run any other program that uses them. Once your 
program terminates, you must enter the UNLOAD command to free those devices. 
Otherwise, your system won't be able to allocate those auxiliary devices to any other 
programs. 

Format 

UNLOAD 

There are no parameters associated with this command. 
Example 

UNLOAD 

This example frees whatever auxiliaiy devices were allocated to a downline-loaded 
program. 
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The following conditions could cause this command to be rejected: 

• Wrong Device 

The UNLOAD command can be initiated only from a UTS 400 terminal or a UTS 
40/40D workstation. 

• Incorrect Sjmtax 

The command was misspelled or ambiguouSj or the command was entered 
improperly. 



2.9. The Upline Dump Command for 
UTS 400 Terminal Users (ULD) 



The upline dump command allows a UTS 400 user to obtain a dump of the terminal 
storage (memoiy). ULD reads from the user programmable region of the UTS 400 
storage and writes the contents to a user-designated disk file. 

There are two command options associated with the ULD command. You can specify 
that the contents of your dump file be printed and/or saved. If you specify the print 
option, ULD automatically schedules the job UPLDUMP for execution after the 
contents of terminal storage (memory) have been written to your dump file. 
UPLDUMP formats and prints the file contents. Once printing is completed, the file 
contents are scratched unless you specified the save option. 

If you do not specify the print option, the contents of your dump file are automatically 
saved. You cannot (and would not want to) specify both the noprint and the scratch 
options. If you try to, the system will ignore your specification and save the file 
contents. 



Format 

ULDA,fnename,vsn,SI2E=nA 

Command Parameters 



J mm I A r mmm i 

\ NOPRINT J I SAVE j 



filename 

Is the name of the file to which you want the contents of the dump written. 
The file name doesn't have to be the name of an existing file. You can 
allocate file space through the ULD command. A file name must be unique 
and can be up to 44 alphanumeric characters long. It must also have a 
comma before and after it. You must enclose the file name in quotation 
marks or apostrophes if there are any spaces, commas, or parentheses 
embedded in it. If you use an already existing file, it must be a MIRAM file. 
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Is the ¥oliime serial number of the disk where your dump file resides. 

You muBt specify the number of disk cylinders you need for your dump file. 
If tiie file you intend to use already exists, this parameter is not needed. 

Command Options 

I iill 1 

I NOPRIMT J 

If you accept PRINT (the default), ULD schedules job UPLDUMP to format 
and print your dump file. When printing is completed, UPLDUMP scratches 
(erases) your dump file unless you specify the SAVE option. If you specify 
the NOPRINT option, UPLDUMP is not scheduled and the contents of your 
dump file are automatically saved. 

llHiffl 1 

1 SAVi I 

You can specify whether or not you want your dump file saved or erased 
after it has been printed. SCRATCH is the defaiJt only if the PRINT option 
was selected. If you don't specify the PRINT option, ULD automatically 
saves your dump file and you cannot scratch it. 

Examples 

ULD ,HYFIL„RES,SIZE-2 SAVE 

In this example, you are writing the contents of your UTS 400 terminal storage 
(memory) to the file called MYFILE. MYFILE is on the volume RES and occupies two 
cylinders of file space. The dump is printed and the file contents are saved. 

ULD ,DUHPFILE,REL082,SIZE=2 

In this example, the dump is written to DUMPFILE, which resides on the REL082 
volume. Two cylinders of file space were allocated for DUMPFILE. The contents of 
DUMPFILE are printed and then scratched since the SAVE option was not specified. . 

ULD ,THEFILE,MYVOL01,SIZE=3 NOPRINT 

In this example, THEFILE is not printed. The contents, however, are saved even 
though the SAVE option was not specified. 

The following conditions could cause this command to be rejected: 

® Wrong Device 

The ULD command can be initiated only from a UTS 400 terminal. 
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® Wrong File Type 

UTS 400 termmal dump can only be written to a MIRAM file. 

® Incorrect SyntM; 

The command was misspelled or ambiguous^ or the command was entered 
improperly. 



2 JO. Changing Job Scheduling 



After your job control stream is read and^ if necessarys expanded, it is placed on a 
priority scheduling queue. It tiien waits until all the system resources it needs become 
available. When tiie resources all become available, tiie job is executed. You can alter 
the scheduling of your jobs as they wait for system resources on the scheduling 
queues. The following commands permit you to defer and reinstate tiie sdieduling ©f 
a jobj delete a job from a scheduling queue, change the sdieduHng priority ©f a job, 
and display a listing ©f the jobs on each scheduling queue. You can alter only the 
scheduling of jobs initiated under the user-id you entered when you lo^ed onto ttie 
system, unless you have been given global control privileges by tiie ^stem 
administrator. For more information, see the Security Maintenance Utility Operations 
Guide (UP-12028). 

2 JO J. Reschedoling Jobs f BEGIN Command) 

The BEGIN command enables you to schedule the execution of jobs deferred by the 
HOLD command. You can reschedule individual jobs or all jobs in the designated 
queue that you control. 

Note: The BEGIN JBQ command reschedules only those jobs that are held in the 
scheduling queue at the time you enter the command. It only affeOsjobs 
initiated under your user-id unless you have been given global control 
priveleges by the system administrator. When the system operator (working at 
the console) issues a HOLD JBQ command, not only are all jobs currently on 
the scheduling queue(s) specified held, but any jobs that are placed on the 
queue(s) after the HOLD JBQ command w issued are also held. 

Format for KeseheduMng Ml Jobs or Jobs in a Particular Job Queue 

BEGIIIAJBQ , I 
H 
N 
P 
L 



2«30 UP-9972 Rev. 2 



Running Jobs from tfie Workstation 



Format for :^scliediiliiig Individiial Jobs 

BE6IMAjobnai« 

ParameteM 

A/M/N/P/L 

Specifies the scheduling priority queue you want to reschedule. Entering A 
reschedules all jobs in all scheduling priority job queues. H reschedules all 
Jobs in the high priority job queue. N reschedules all jobs in the normal 
priority job queue. P reschedules all jobs in the preemptive priority job 
queue. L reschedules all jobs in the low priority job queue. 

jotaane 

Specifies the name of the job you want to reschedule for execution. 

Example 

BE MQ,n 

In this example, all jobs initiated under your user-id in the normal scheduling priority 
job queue, which has been placed on hold, are now rescheduled for execution. 

The following condition could cause tiiis command to be rejected: 

® Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 

2.10.2. Deferring Jobs (HOLD Command} 

The HOLD command enables you to defer the scheduling of jobs. You can hold 
individual jobs or all jobs in the designated queue that you control. The job you hold is 
not scheduled until you enter a BEGIN command to remove the job from hold status. 
(To see what jobs are already on HOLD, use the DISPLAY JBQ command.) 

Format for Def emng Ml Jobs or Jobs on a Particular Job Queue 



MOLDAJBQ 
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Format for Deferring an Individual Job 

HOLDAJobnane 
Parameters 

A/H/N/P/L 

specifies which job queue you want to place on hold status. Entering A 
holds all jobs in all job queues. H holds all jobs in the high priority job queue. 
N holds all jobs in the normal priority Job queue. P holds all jobs initiated 
under your user-id in the preemptive priority job queue. L holds all jobs in 
the low priority job queue. 

Example 

HO JBQ.N 

In this example, the jobs initiated under your user-id on the normal priority job queue 
are held from execution. 

The following condition could cause iMs command to be rejected: 

® Incorrect Syntax 

The command was misspelled or ambiguous, ©r the command or parameters were 
improperly entered. 

2 J0.3. Displaying the Contents of a Job Queue 
(DISPLAY JBQ Command) 

The DISPLAY JBQ command enables you to display the contents of each scheduling 
priority job queue on the workstation screen. The display shows all the jobs residing 
in the queue, or queues you specified, by their job names. The job names of jobs 
deferred from scheduling by the HOLD command are displayed enclosed in 
parentheses. 

Format 

H 

n 
p 

L 
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Pa^imeters 

i/H/M/P/L 

Specifies the scheduling priority job queue you want displayed. Entering A 
displays the contents all three job queues: preemptive first, then high^ and 
tiien normal. H displays the contents of the high priority job queue. N 
displays the contents of the normal priority job queue. P displays the 
contents of the preemptive priority job queue. L displays the contents of the 
low priority job queue. 

Example 

DI JBQ.P 

In this examples the contents of the preemptive priority job queue are displayed. 

.The following condition could cause this command to be rejected: 

• Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 

2A0A. Deleting Jobs from a Job Qyeye IDELETE Command) 

The DELETE command enables you to remove jobs from scheduling job queues. You 
can delete individual jobs, or all jobs in a particular queue, or all jobs in all queues. 

Format for Deleting an Individual Job 

D|LETEAjobnai«[,LOO] 

Foi^mt for Deleting AH Jobs on a Queue or AH Jobs in the System 



DELETEAJBO, 



CLOG] 
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Parameters 

jobiane 

Is the 1" to 8-character name of the job you want to delete. 

i/H/N/P/L 

Specifies the job queue from which you want to delete all jobs. Entering A 
causes all sudi jobs to be deleted from all queues. H causes all such jobs to 
be deleted from the high priority queue. N causes all such jobs to be deleted 
from tiie normal priority queue. P caiwes all such jobs to be deleted from ttie 
preemptive job priority queue. L cai^es all such jobs to be deleted from the 
low priority queue; and 



LOG 



Causes ttie job log to be printed. 



Exflmplc 

DE JBa.M 

In ttiis example, all jobs that are on the normal priority job queue are deleted. 

The following condition could cause this command to be rejected: 

® Incorrect S3mtax 

The command was misspelled or ambiguous, or tiie command ©r parameters were 
improperly entered. 

2.10.5. Changing tfie Scheduling Queue of a Job 
(CHANGE Cominandl 

The CHANGE command enables you to move a job from one job queue to anotiierj 
thus changing the scheduling priority of the job. If the job was in HOLD status on its 
original job queue^ it retains that HOLD status on its new job queue. 

Format 



CHAMGEAjofcnaiie, 
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Parameters 



Is the name of the job whose job queue you want to change. 

H/M/P/L 

Specifies in which job queue you want to place tiie job. H specifies the high 
priority queue. N specifies the normal priority queue. P specifies the 
preemptive priority queue. L specifies the low priority queue. Do not move 
jobs from the normal priority queue to the high or preemptive queues, or from 
the high to the preemptive queue without first consulting your site 
administrator. 

Example 

CH MY JOB, i 

In this example^ the job MYJOB is changed from either a high priority or a preemptive 
priority to normal priority. 



2 Jl. Connecting a Workstation to a Job 



In order to use workstations with a job, the workstations must be connected to the job. 
The workstations are actually connected to one or more files, created by the job to 
interface with workstations. The workstation mode of the workstations is connected 
to the files. There are several ways to connect workstations to the files. One method 
is through job control. When you create the job control stream for a job using 
workstations, certain options of the UID job control statement can be entered to cause 
workstations to be automatically connected' to a job. Complete information on using 
job control to connect workstations can be found in the Job Control Programming 
Guide (7004 4623). 

If you want to connect to a job that has no automatic connection provision for your 
particular workstation, use the CONNECT workstation command, described in the 
following pages. System programs and interactive facilities automatically connect the 
workstation from which they were invoked. 

Note: A job using workstation files cannot be restarted from a checkpoint taken 
when the workstation files are open. 
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2J1J. The CONNECT Command 

The CONNECT command enables you to connect workstation mode to a job. You can 
connect only to jobs that have been written to recognize workstations. You can issue 
the CONNECT command when the job is executing or on a job queue. 

Note: You cannot issue this command from a menu action table. 

Format 

COHNECTAjobC.fflenane] 

Parameters 

job 

Specifies the name of the job to which you want to connect the 
WORKSTATION mode of your workstation. 

Specifies the name of the workstation file to which you want to connect This 
parameter is required when there is more than one workstation file defined 
within the job. The file name can be up to 17 alphanumeric characters long. 

CON COLLECTS, BILLS 

In this example, the workstation is connected to the workstation file BILLS of the job 
COLLECTN. 

The following conditions could cause this comand to be rejected: 

• Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
entered improperly. 

• Attempt to Connect to a Job That Cannot Handle Any More Workstations 

The number of workstations that you can connect to a job is set by a statement in 
the job control stream used to run the job. No more than the number specified 
will be accepted. 

• Attempt to Connect to a Job That Does Not Expect Workstations 

You can connect only to a job that has been specifically written to use 
workstations. 
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• Attempt to Connect to a Nonexistent Kle or Job 

You can connect only to jobs either executing or waitmg for execution on a job 
queue. You ean connect only to workstation files defined within the program. 

• Implied Disconnect Cannot Be Accomplished 

For some reason, the system is unable to disconnect your workstation from ihe 
job it is currently connected to. Cannot accomplish the CONNECT command. 

• Attempt to Connect to an Inactive Job 

You can connect only to a job that is active, i^e., executing on the system or on a 
job queue. 

212. Changing the Master Workstation 

When a job is initiated at a workstation^ that workstation normally has control of that 
Job. The workstation functions as a minisystem console for tiie job. The workstation 
initiating the job has control regardless of the number of workstations subsequently 
connected to it. The controlling workstation is designated the master workstation for 
tiie job. Messages from the system concerning the job are routed to the master 
workstation, and responses to those messages and commands entered to control the 
job can be issued only from the master workstation. This is particularly important for 
commands. Many commands in this guide state that you can perform the command 
only on jobs initiated or running under your user-id. Since the user-id designates the 
master workstation, this means that only the master workstation of a job can perform 
commands on that job. You can change the master workstation. However, the 
workstation you designate as the master workstetion is the only workstation 
controlling a particular job. 

The master workstation status of a workstation is maintained by the user-id you 
enter when you log on the master workstation. The user-id is saved by the system; it 
is appended to all commands entered at tiie workstation and all jobs for which that 
workstation is designated as the master workstation. If your system has DDP, you 
can also designate the host-id of a particular host that you want to control a job. 

When a command is entered against a particular job, the system matches the user-id 
of the command against that of the job the command is directed to. If tlie user-ids 
match, the command is executed. If they do not match, the command is rejected. 
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Figure 2-3 illustrates the manner in which the user-id controls program access. A 
command issued by the workstation logged on under user-id USERA cannot affect 
MYJOB, because MYJOB is under the control of a master workstation having the 
user-id USERB. 




Command 



— \ 

USERA \ 



USERB 


MYJOB 


_^_ 


Vn^ 


^z^ 


"^T^ 


-"t^ 


n~]r 


1^ 


Dzzr^ 



Figyre 2-3. How the User-id Controls Access to Jobs 

You can designate a workstation other than the initiating workstation as the master 
workstation for a job. There are two methods you can use. The first is to log off from 
the workstation designated as master workstation for a particular job, and log on to 
another workstation. If you log on under the same user-id you used to log on to the 
initiating workstation, the workstation you log on to becomes the master workstation. 

The second method of designating a master workstation uses two parameters of the // 
OPTION job control statement. 

ORI=[host-id:]user-id 

Designates whatever workstation is logged on under the specified user-id as 
the master workstation. If your system has DDP, you can use the host-id to 
specify a particular host If you omit the host-id, the local host (the processor 
on which the job is executing) is assumed. The host-id is optional but, if 
specified, must be followed by a user-id. The ORI option takes effect as soon 
as it is detected in the control stream, before the job is placed in the job 
queue. The workstation from which the command to start the job was 
initiated is no longer designated the master workstation for the job. The 
user-id can be from one to six alphanumeric characters long. 

Note: ORI=user-id cannot be specified in a job initiated from a remote 
batch terminal. 
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MAS=[host-id;]user-id 

Designates whatever workstation is logged on under the specified user-id as 
the master workstation. The MAS option takes effect when the job is placed 
in the job queue. If your system has DDP, you can use the host-id to specify 
a particular host. If you omit the host-id, the local host (the processor on 
which the job is executing) is assumed. The host-id is optional but, if 
specified, must be followed by a user-id. 

Note^ You cannot specify MAS=user-id in a job initiated from a' remote 
batch terminal 

You can use ORI and MAS together, designating one workstation as the 
master while the job is being acted upon by the run processor, and another 
when the job goes onto a scheduling priority queue. By entering (EXEC) 
immediately after the user-id with MAS, the user-id specified will not 
change the master workstation designation until the job begins executing. 
Thus, the workstation specified by ORI controls the job while it is on a 
scheduling priority queue, and relinquishes control to the workstation 
specified by MAS only when the job begins execution. 

For more detailed information on these job control statements, refer to the Job 
Control Programming Guide (7004 4623). 

If you initiate a job from a workstation and then log off that workstation and do not 
designate another workstation to take over, messages concerning the job are routed to 
the system console. The system console can always control all jobs running on the 
system. 
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Section 3 

General Workstation Commands 



3.1. Introduction 

This section covers the following workstation commands: 

1 . Commands to control the job processing environment 

These commands enable you to communicate with the system operator, to obtain 
the status of your job, and to stop, restart, and terminate your job. 

2. Commands to control output spooling 

Spooling provides a buffer between the high-speed components of your system 
(such as the central processor) and the low-speed components (such as the 
printer). 

3. Commands to control workstation logging 

Workstation logging automatically creates a record of all system commands 
issued from your workstationj system messages sent to your workstation, and the 
responses you make to those messages. 
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3.2. Commands to Control the Job 
Processing Enwironment 

3.2. 1 e Asking Questions of Otter Workstation Users 
|ASK Commandl 

The ASK command enables you to ask questions of other users or the system operator. 
The command displays your question to tiie ©tiier user^ accepts the reply, and returns 
tile reply to you. You. do not have to wait for a response to your ASK command before 
entering another one. 

Format 

MKACuser-id.J'text' 

user* ID 

Specifies the user-id of tiie user you. want t© question. If you do not specify a 
user-id, the question is routed to the console operator, ^Hie console, however^ 
has a user-idj which you can use in communicating with tiie console operator. 
It is $Y$CON. If you want to ask a question of a user who has initiated an 
ENTER file, enter $Y$MAS as the user-id. 

'text' 

Is tiie text of your question to the operator, ^e text can be a maximum of 88 
characters long, A longer text causes the command to be rejected. A comma 
must separate the text from the user-id. If tiiere is no user-id, you do not 
need to enter a comma. You must enclose the tat in apostrophes and enter 2 
consecutive apostrophes to represent any apostmphes contained inside your 
text. For acample: 

ASK MARK/ISN'T THE WEATHER GREAT?' 
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Example 

A user with user-id ANDY keys in the following question and sends it to a user 
witfi user-id MARK (in system mode): 

ASK MARK, 'IS DISK "RELPAK" AVAILABLE MW?« 

User MAKK sees this question on Ms workstation screen in the form: 

12?ASK883 IS67 MARKi IS DISK "RELPM" AVAILABLE Umf 

User MARK responds: 

12 YES 

User ANDY then sees the following message on Ms screen: 

25 ASK083aiS67 AiD¥: YES 

Note: Ml responses are entered in system mode. 

The following conditions could cause this command to be rejected: 

• Incorrect Syntax 

The command was misspelled or ambiguous, the user-id was longer ttian six 
characters^ or apostrophes were used incorrectly. 

• Message Too Long 

The message text is longer than 88 characters. Hie command is rejected^ 

3.2.2. Canceling a Job [CANCEL Command} 

The CANCEL command enables you to immediately halt processing of a job. When 
you enter the CANCEL command^ the job is brought to an immediate halt; the job step 
currently executing is not completed, and any remaining job steps are not executed. 
CANCEL can be entered any time during job processing. You can perform a CANCEL 
only of jobs executing under your user-id unless you have been given global control 
privileges. 
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Format 

CAMCELAj 

Pa^i^eters 



'{"} 



Specifies the name of the job you want to cancel. 

D/i 

Specifies whether or not you. want a dump to be taken when the job is 
terminated, regardless of the dump option specified in the Job control stream 
for the job. D specifies that you want a dump taken; N specifies that you do 
not want a dump taken. If you omit this parameter, the dump options 
contained in the job control stream for the job remain in effect. 

Example 

CA MY JOB, D 

In this example, the job named MYJOB is canceled. A dump is taken, regardless of the 
dump option specified in the job control stream for the job. 

The following condition could cause this command to be rejected: 

• Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 



Soft Cancel fCJ} Command 



The soft cancel command (CJ) has the same parameters as the CANCEL command. 
The soft cancel takes effect only when the following conditions are met: 

• The job is not in shared code. 

• The job is in its own key. 
Format 



CJAjobnane 



'{2} 
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Example 

CJ MY JOB, N 

In this example, tiie job named MYJOB is cancelled and no dump is taken. 

The following condition could cause this command to be rejected: 

• Incorrect Syntax 

The command was misspelled or ambiguous^ or the command or parameters were 
improperly entered. 

3.2 J. Obtaining Job Statas Information fDISPLAY JS Command) 

The DISPLAY JS command enables you to obtain information about jobs either 
initiated or running under your user-id. The command produces a 1-line display of the 
current status of the job about which you inquired. You can request information only 
about jobs either initiated or running under your user-id, unless you have been given 
global status privileges by the system administrator. 

FoiMiat 

OiSPLAYAJS[,jobnane][,alU 

Pai^meter 

jobnane 

Is the 1- to 8-character name of the job about which you want information. If 
you include a job name with the DIJS command, you will receive 
information ^©ut tiie job, whether it is in main storage or on a job queue. If 
you do not include a job name, you will receive information about all jobs 
under your user-id that are in main storage, but not those on job queues. 
Information about jobs is displayed one line at a time. If you entered no job 
name, press the transmit key after the first line of displayed job information 
to see information about other jobs. The command concludes when DISPLAY 
END appears after you press the transmit key. 

ail 

If you include all, you receive information about all jobs under your user-id 
that are in main storage and in the job queue. 

Example 

Dl JSjMYJOB 

In this example, a display is produced of status information about a job named 
MYJOB. 
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The following lines are examples of the messages produced by the DISPLAY JS 
command. The examples show what information DI JS might display if it were 
entered against MYJOB as it proceeds through the various steps in job processing: 



52 011945 MYJOB IM STEP 1(LMK:EDT)-PRI-10 CPU-TIME=00:01 i43.874 

In this example, MYJOB is active in its first step, performing linkage editing. The 
CPU TIME portion of the display indicates that the linkage editor has had control of 
the CPU for 1 minute, 43 seconds, and 874 milliseconds. If the job is proceeding, you 
can reenter DI JS for MYJOB and see an increase in the CPU TIME figure. 



53 DI1945 MYJOB IN STEP 2(L!BS00) -WAITING FOR I/O #00005736 

In this example, MYJOB is in its second step, executing the librarian. Currently, the 
5736th I/O operation of this step is being performed. If you reenter DI JS, you can see 
the FO number increase. If MYJOB remains at #00005736, it might be stuck, 
requiring your intervention. 



54 DI1945 MYJOB IN STEP 03 -IN STEP PROCESSOR 

In this example, MYJOB is between job steps. Step 03 either has just completed or is 
about to start. 



55 DI1945 HYJOB NOT YET SCHEDULED- INSUFFICIENT MAIN STORAGE 

This example shows a m.essage you would receive if MYJOB is not executing. In this 
case, MYJOB was placed on a job queue but has not been scheduled for execution 
because not enough main storage is available. 

The following conditions could cause this command to be rejected: 

® Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 

® Invalid Access Attempt 

An attempt was made to access a job that is not on the system or is under another 
user-id. A message is displayed indicating that the job is not on the system in 
either case. You are not permitted to obtain status information from jobs other 
than those under your user-id. 
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3.2.4. Disconnecting a Workstation from a Job fFREE Command) 

The FREE command enables you to manually disconnect a workstation from a job. 
After you issue a FREE command, the workstation mode of the workstation 
disconnected is unassigned and can be reassigned to another job. The FREE command 
is not normally required, because end-of-job processing procedures automatically 
disconnect all workstations assigned to the job. Also, when you issue a CONNECT 
command to a workstation already assigned to another job, the CONNECT command 
issues a FREE command to disconnect the workstation before the CONNECT 
command is accomplished. The FREE command is most useful in allowing a 
frequently accessed job to be idled for short periods of time, but not removed from 
main storage. This permits the job to be accessed quickly, without having to wait for it 
to be rescheduled. 

Note: You cannot issue this command from a menu action table. 

Format 

FREE 

There are no parameters associated with this command. 

The following conditions could cause this command to be rejected: 

® Incorrect Syntax 

The command was misspelled or ambiguous, or the command or syntax was 
entered improperly. 

® Workstation Not Assigned 

You cannot disconnect a workstation that was not connected to a job in the first 
place. 

® Command Not Permitted with Job Control 

You can not use the FREE command when you specified automatic connection of 
workstations in the job control stream used to run the job. 
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3.2.5. Suspending Job Processing (PAUSE Command} 

You use the PAUSE command to suspend processing of a job. You can enter the 
PAUSE command at any time, and processing of the specified job is immediately 
suspended. If the job is between job steps, PAUSE takes effect at the beginning of the 
next job step. You reactivate a job suspended by the PAUSE command by entering the 
GO command. You can suspend only jobs executing under your user-id, unless you have 
been given global control privileges by the system administrator. 

Format 

PAUSEAjobnaneE , job-step-no] 

Parameter 

jobname 

Specifies the name of the job you want to suspend. 

job- step-no 

Is a two-character job step number. You cannot cancel any job paused with a 
job step number option until the job is resumed. 

Example 

PA MYJOB.nn 

In this example, the job MYJOB with job step number nn is suspended. 

The following conditions can cause this command to be rejected: 

• Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 



# 



No Job Name Specified 

You must specify a job name with this command. 
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32£. Reactivating Suspended Jobs (GO Command} 

The GO command is used to reactivate jobs that were suspended by using the PAUSE 
(3.2.5) command, or by job control operations. You can reactivate only jobs executing 
under your user-id, unless you have been given global control privileges by the system 
administrator. 

Format 

G0Ajobname[,nn3 

Parameter 

jobname 

Is the name of the job you want to reactivate. 



Is the number of the action message. This allows you to suspend multitask 
jobs and start other tasks through action messages. 

Example 

GO HYJOB 

In this example, the job named MYJOB is reactivated after it was suspended. 

The following conditions can cause this command to be rejected: 

• Incorrect Syntax 

The command is misspelled or ambiguous, or the command or parameters were 
improperly entered. 

® No Job Name Specified 

You must specify a job name with this command. 
® Job Not Suspended 

The job you are trying to reactivate was not suspended. 
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3.2.7» Resuming Subsystem Execution "{RESUME Command) 

The RESUME command enables you to resume execution of the general editor or the 
BASIC programming language, which was suspended when the workstation entered 
SYSTEM mode. 

Format 

RESUNE 

There are no parameters associated with this command. Entering anything as a 
parameter for this command causes it to be rejected. 

The following conditions can cause this command to be rejected: 

• Incorrect Syntax 

The command was misspelled or ambiguous, or the command was entered with 
parameters. 

® No Program to Resume 

No subsystem was suspended, so none can be resumed. 

3«2.8s Altering Display Characteristics {SCREEN Command) 

The SCREEN command enables you to alter some operational characteristics of the 
workstation or terminal with which you are working. The SCREEN command sends 
you a message informing you when it has completed processing. The SCREEN 
command permits you to alter screen control and display characteristics and input 
translation. 

You can issue the SCREEN command at any time during a workstation session. 
During a session, it affects batch jobs as well as interactive facilities like the general 
editor, BASIC, and DDP. Moreover, each workstation user can issue a SCREEN 
command. If several workstations are connected to one job, each workstation operator 
can control his workstation or terminal independent of other users. 

You can use more than one line of the workstation screen to enter this command and 
its associated parameters. To do this, place a dash (-) as the last character in the first 
line of the command. The system recognizes the dash as a continuation character and 
asks you (in a message) for further input.^You can use as many lines of the screen as 
you want; just place a dash at the end of every line except the last one. 
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Format 



SCREEMA 



t 


lilpSil 1 
iipii 




MP 




WRAP 




^OROLL 



jilpiiB 1 

I LWER I 



.M"= 


MM 1 




.XFERs 


■ VAR 




■ 


CHAU 






CHAN 






. ^LL 






jipl 





.SPEEDS 


liilii ■ 

2400 






J280 
600 






. 300 





.SPACEBAR 



= r DESTRUCT 1 , LIMES- f P 1 

liipffiSB I i 12 I 



,PYB0ARD= pIpiiDm 1 
I KATAKAMA J 



,mE^SITY= 



MORMAL 
REVERSE 



,LOG= f ALL 



J ALL I 



\ W:STH I I BURST J \ PAGE J 



, J HEADER 1 
[ NOHEADER J 



,SI = 



BOTTOf 



Parameters 

iliplifflHi/MP/WRAP/MORpLL 

Specifies screen control characteristics. Normally, the cursor moves from the 
last character position on the last line of the screen to the first character 
position on the top line of the next screen (called wrapping). You can change 
the screen so that, when the cursor reaches the last character position of the . 
bottom line, it moves to the first character position of the top line of the 
screen and the contents of the screen are erased. This is the NP option. Or, 
you can change the screen so that, when the cursor reaches the last character 
position of the bottom line, it causes the bottom line to move up one and 
bump the top line off the screen. The cursor then moves to the first character 
position of the new, blank, bottom line (called scrolling). To change from 
wrapping to scrolling, specify SCROLL or ROLL. If you have changed from 
wrapping to scrolling and want to return to wrapping, specify WRAP or 
NOROLL. When applied to a System 80 workstation or System 80 console 
workstation, this parameter affects only workstation mode. 
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Specifies whether lowercase letters are translated to uppercase upon input 
or remain lowercase. Specify UPPER if you want lowercase letters translated 
to uppercase. Specify LOWER if you want the lowercase letters to remain 
lowercase. When applied to a System 80 workstation or console workstation, 
this parameter affects only workstation mode. 

XMIT^ii/CHAN/ALL 

Specifies what portion of the data entered on the screen is transmitted to the 
system. VAR specifies that only the unprotected data on the screen be 
transmitted. This is the most widely used mode and is required by screen 
format services. CHAN specifies transmitting only those fields changed by 
the workstation user. ALL specifies that all data, protected and unprotected, 
be transmitted. This parameter is valid only when specified for a System 80 
workstation or a console workstation. 

XFER=VAR/CHAMKi 

Specifies what portion of the data entered on the screen is transferred to a 
peripheral device connected to the workstation or terminal. The three 
options, VAR, CHAN, and ALL, are the same as for the XMIT parameter. 
This parameter is valid only when specified for a System 80 workstation or a 
console workstation. 

SPEEDi9$ei/480@/24g0/ 1 200/600/300 

Specifies the speed of the line connecting the workstation and any 
peripherals attached to the workstation. The speeds are given in bits per 
second. The default value of 9600 bits per second is for direct-connected 
workstations. This parameter is valid only when specified for a System 80 
workstation or console workstation. 

SPACEBAR=DESTRUCT/NONOESTRUCT 

Specifies whether the space bar destroys the character beneath the cursor as 
it advances or just advances the cursor. DESTRUCT specifies that 
characters beneath the cursor are replaced with blank spaces as the cursor 
advances. NONDESTRUCT specifies that the spacebar just advances the 
cursor without destroying the characters beneath it. This parameter is valid 
only when specified for a System SO workstation or console workstation. 

UMESi24/12 

Specifies the number of lines on the workstation display screen. The 
indicator line present on workstation screens is not included in this count. 
The LINES option does not apply when your workstation is in data mode 
(that is, if you are using the general editor or any other interactive facility). 
This parameter is valid only when specified for a System 80 workstation or 
console workstation. 
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KEYBOARD^iiS^/pTAKANA 

Specifies whether the keyboard generates standard English alphabetic 
charaeters or Katakana (Japanese) charaeters. This parameter is valid only 
when specified for a System 80 workstation or console workstation having the 
necessary hardware to produce either Katakana or English characters. 

iMTEMS I T Y-MORMALi^ip/REVERSE 

Specifies the type of video a¥ailable for protected fields of data displayed by 
programs. NORMAL specifies tiiat the protected fields appear the same as 
the unprotected fields at normal intensity. LOW specifies that low-intensity 
video is produced. REVERSE specifies that reverse video is produced. This 
parameter is valid only when specified for a System 80 workstation or console 
workstation. 



LOG=ALLy 

Specifies which commands your workstation logs include. ALL specifies that 
your logs show all commands you enter - both in system mode and 
workstation mode. COMMANDS, tiie def ault^ specifies that your logs show 
only commands entered in system mode. For example, if you specify 
LOG=ALL and activate the general editor, your log shows the system 
command EDT that activated the general editor, along with all of the editor 
commands you enter in workstation mode during your EDT session. 
However, if you do not specify the LOG parameter or specify 
L0G=C01ftiANDS, your log shows only the system command EDT, without 
any of your EDT commands. 

lEpRH/yKSTII 

Specifies where your system prints your print files. Specif3dng CENTRAL, 
or omitting the parameter, directs all your print files to the central site 
printer. How your files are printed depends on how you specify the 
NONBURST/BURST parameter of the SCREEN command. Specifying 
WKSTN directs all print files to the workstation auxiliaiy printer regardless 
of your specification for the NONBURST/BURST parameter. WKSTN 
applies only t© print files for interactive products, specifically, EDT, 
ESCORT, BASIC, ©r the interactive services PRINT command. (For print 
files from your own jobs to be printed at an auxiliaiy printer, their job 
control must specify auxiliary printer output. See Spooling and Job 
Accounting Concepts and Facilities (UP-8869).) If you choose WKSTN, make 
sure the auxiliaiy printer is available and ready for use. 
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Note: If you specify WKSTN at a workstation that is not connected to an 
auxiliary printer, your system holds your print files until you do the 
following three things: 

1. Logoff that workstation. 

2. Log on to the workstation that is connected to an auxiliary 
printer under the same user-id. 

3. Issue an RP spooling command. 

Then, your system prints your files at the auxiliary printer. 

The SCREEN command issued with either of these parameters 
does not affect the printing of any file that had already begun 
before you issued the SCREEN command. 

wmm/mMsj 

Specifies when your system prints all print files that you've sent to the 
central site printer through the CENTRAL parameter of the SCREEN 
command. Specifying NONBURST, or omitting the parameter, tells your 
system to print all print files that you sent to the central site printer 
according to your specification for the SPOOLBURST parameter during 
SYSGEN. If SPOOLBURST=YES at SYSGEN, then your system prints all 
print files as soon as they are sent to the central site printer. If 
SPOOLBURST=:NO, it holds all print files until you log off. Then it prints 
them all together, along with your workstation log file. Specifying BURST 
tells your system to print all print files that you've directed to the central site 
printer, regardless of what you have specified for the SPOOLBURST 
parameter at SYSGEN. 

The SCREEN command issued with either of these options does not afifect 
the printing of any file that began before you issued the SCREEN command. 

Note: In some cases, system programs override NONB URST or B URST. 
For instance, the EDT LIST command includes a parameter that 
lets you print files immediately, without waiting until you log off. If 
you were to specify this parameter, your system would print your 
files immediately, even if you had previously specified SCREEN 
NONBURST during your current workstation session and had 
specified SPOOLBURST=NO during SYSGEN. 
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mimi/PAGE 

Specifies the printing mode for any 0791 auxiliary printer connected to the 
workstation. CONTINUOUS causes output to be printed in continuous 
mode. That is, output prints continually as in normal printer operation. This 
option is the default. PAGE causes output to be printed in page mode. That 
is, the system requests the operator to insert the next page into the printer 
prior to the printing of each page. Both options are ignored if no 0791 printer 
is attached to the workstation. 

You can enter a SCREEN command that specifies PAGE or CONTINUOUS 
any time before the print file starts printing. The page mode remains in 
effect unless changed by another SCREEN command or unless the system 
IPL procedure is performed again. In the second case, the continuous mode 
becomes effective. If you alternate between the two modes, you can enter the 
command before you respond to the forms mount message. If the SCREEN 
command is entered after a file begins printing, the command is not effective 
until the next file is printed. Logging off the workstation has no effect on the 
page mode setting. 



si= 



r» 1 
I Bonm I 

Specifies where the emulated system response and input line appears on the 

screen. SfcTOP, the default, specifies the top two lines. The system 

responses appear on line 2 and you enter message responses and unsolicited 

messages on line 1. 

SI=BOTTOM moves the emulated SYSTEM mode message and input line to 
tiie bottom of the screen. This command to move the SYSTEM mode to the 
bottom of the screen does not take effect until you request the SYSTEM 
mode again. 

Using this parameter allows users to switch to SYSTEM mode while 
reducing the opportunity of causing an SF16 error. The top two lines are 
destroyed if you use the default (SCREEN SI=TOP). SI=BOTTOM does 
destroy the bottom two lines and an SF16 error can result, if the ciirsor is 
positioned on these bottom lines when the system response area is moved. 

iiffiii/NOHEADER 

Specifies whether the headers printed for an auxiliary printer at a 
workstation are printed or suppressed. To suppress them, issue SCREEN 
NOHEADER after issuing the SCREEN WKSTN command. This 
suppresses page separators until you issue a SCREEN HEADER command. 
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Example 

SCR ROLL.LCWER 

In this example, screen control is set for scrolling. Lowercase letters remain lowercase 
and are not translated to uppercase. 

The following condition can cause this command to be rejected: 

• Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 

3=2.9. Terminating a Job at tie End of a Job Step 
fSTOP Commandl 

The STOP command enables you to terminate a job at the completion of the currently 
executing job step. The STOP command differs from the CANCEL command in that 
the CANCEL command immediately halts the job, without allowing completion of the 
currently executing job step. You can perform a STOP only for jobs executing under 
your user-id, unless you have been given global control privileges by the system 
administrator. 

Format 

STOPA jobnanet , job- step-no] 

Parametera 

jobnane 

Specifies the name of the job you want to bring to an orderly termination. 
The job name can be up to eight characters long. 

job- step -no 

Is the two-character job step number. 

Example 

ST MYJOB,nn 

In this example, the job named MYJOB with job step number nn is brought to an 
orderly termination. 
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The following conditions can cause this command to be rejected: 

• Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
entered improperly. 

• No Job Name Entered 

You must enter a job name to execute this command. 

3.2 JO. Sending Messages to the System Operator 
(TELL Commaodl 

The TELL command enables you to send messages not requiring a response to other 
users or the system operator. 

Format 



TELLA 



J user- id 1 , 
I ALL I 



i text ' 



Parameters 

user-id/ALL 

Specifies the user-id of the user you want to send the message to. If you do 
not specify a user-id, the message will be sent to the system operator. The 
console, however, has a user-id that you can use in communicating with the 
system operator; it is $Y$CON. If you want to send a message to a user who 
has initiated an ENTER file, enter $Y$MAS as the user-id. If you specify 
ALL, the message will be sent to all users on the system, as well as the 
system operator. 

text 

Is the text of the message to be sent to the operator. A comma must separate 
the text from the user-id. If there is no user-id, you do not need to enter a 
comma. The text can be a maximum of 88 characters long. Longer messages 
are rejected. The text must be enclosed in apostrophes and, therefore, can't 
contain apostrophes itself unless you enter 2 consecutive apostrophes to 
represent the apostrophe contained inside your text. For example: 

TELL ALL/ISN'T THE WEATHER GREAT?' 
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Example 

TEL 'PRINTOUT FROM PAY JOB IS NO GOOD* 

In this example, the user is telling the system console operator that the printout of the 
specified job (PAYJOB) is iinacceptable. 

The following conditions can cause this command to be rejected: 

• Incorrect Syntax 

The command was misspelled or ambiguous, apostrophes were used incorrectly, 
or the user-id entered was longer than six characters. 

• Messages Too Long 

The message text was longer than 88 characters. The message is rejected. 



33. Commands to Control Spooling 



33 A. Introduction 



These commands enable you to control the process of spooling (simultaneous 
peripheral operations online). Spooling permits both the high-speed components of 
your system (such as the central processor) and the low-speed components (such as the 
printer) to operate at their optimum speed. Spooling acts as the buffer to ensure that 
high-speed components are not bound by the slow-speed components. In the operation 
of spooling, input from a low-speed device such as a card reader is collected in the 
spool file on disk for high-speed transfer to the central processor. The high-speed 
output from the central processor is transferred back to the spool file, from which it 
can be output through a low-speed device such as a printer or card punch. For 
complete information on spooling, refer to the Spooling and Job Accounting 
Operating Guide, 7004 4581. 

Note^ You can access only those spooled files created by jobs initiated or running 
under your user-id. However, if you have the proper security privileges, these 
commands act as though they were entered at the system console. They have 
access to all spool subfiles in the system. 
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3.3.2, Spooling Command Directories and Modifiers 

When you enter a command to act upon a spooled file, you also enter information to 
define the file to the system. The information you enter to define the file is of two 
types: 

1. The spool file directory 

2, The spool file modifiers 
Spool File Directories 

Whether low-speed input or output devices interface directly with the central 
processor or are buffered by the spool file is transparent to your program. It always 
considers the input to be coming directly from the low-speed device. Therefore spooled 
files are identified in the spool file according to the low-speed device with which they 
are associated. For example, a file coming originally from a card reader would be 
identified as being in the card reader (RDR) directoiy. Note, however, that diskette 
input files are in the RDR directory, while diskette output files are in the PUNCH 
directory. Note also that there is a directory called the LOG directory. This directory 
contains job log information on jobs running in the system. Job log information 
includes the job control used to run the job, messages sent to the workstation or 
console controlling the job, and job accounting information. Table 3-1 lists the spool 
file directories that spooling commands act upon. 



Table 3-1. Spool File Directories 



Directory 



File Function 



ALL 

DDPPR 
DDPPU 
LOG 

PUNCH 
PRINT 
RBPIN 
RBPPR 
RBPPU 
RDR 



All directories are accessible. 

Distributed data processing output is to printer. 

Distributed data processing output is to card fxjnch. 

Job, workstation, and console log input and output is in designated log 
subfile. 

The file is output to either a card punch or a diskette. 

The file is output to a printer. 

ReiTOte batch processing input is from card reader. 

Remote batch processing output is to printer. 

Remote batch processing output is to card punch. 

The file was originally input from a card reader, tape, or diskette. 
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Spooled File Modifiers 

You can farther define the characteristics of the file you want to reference in your 
command. The spooled file modifiers serve this purpose. 

• ACCT=acctno 

Specifies a 1- to 4-character number that is the account number of the job 
creating or using the file. 

• BNUMB=binaryjobno 

Specifies a 5-digit binary job number. Used with BEGIN SPL, DELETE SPL, 
HOLD SPL, PR, PU, and RP commands. 

• CAET=cartridge-name 

Specifies a 1- to 8-character identification of the print cartridge used in the 
printer specified to print the file referenced. 

® COPIES=nnn 

Modifier used only by the CHANGE SPL (CH SPL) command described in 3.3.10. 
It designates the number of copies for spooled files. 

• DDPID=host-id 

Specifies the DDP host (job initiator) of up to four characters. 

• DEV=nnnn 

Designates the type of printer used for output of the file referenced. Refer to the 
Spooling and Job Accounting Operating Guide, 7004 4581, for a list of the device 
numbers you can use. 

• DVC=nnnn 

Modifier used only by the CHANGE SPL (CH SPL) command described in 3.3.10. 
It designates the device type to change to. Refer to the Spooling and Job 
Accounting Operating Guide, 7004 4581, for a list of the device numbers you can 
use. 

• FILE=filename 

Specifies the name of the file. It is from one to eight characters long. 
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• FOEM=formname 

Specifies the name of the form to be used when printing the file. It is from one to 
eight characters long. 

• ID=remote-id 

Specifies the remote batch file identification of up to six characters. 

• JOB=jobname 

Specifies the name of the job creating or using the file. It is from one to eight 
characters long. 

• LBL=labeIname 

Specifies the label name of up to 8 characters for data set label diskette, up to 17 
characters for card reader. 

• STEP=stepno 

Specifies the number of the job step that created or uses the file. It must be at 
least three characters long and left-justified with zeros. 

• UID=USERID 

=0S3CTR or CENTRAL 

USERID 

Identifies the user on whose behalf the spool subfile was created. This 
modifier is not accepted from an interactive user who does not have the 
required security permission, unless UID is the current logon user-id. This 
modifier is from 1 to 6 characters in length. 

0S3CTR or CENTRAL 

Designates subfiles that were directed to a central printer. When entered by 
an interactive user, only centrally destined files that were created under the 
current logon id will be found unless that id has been given security 
privileges. 

Note! If UID^ and DEV- are used together, the DEV specification has priority. 

® VOL=volno 

Specifies the volume number of up to six characters (for diskette only). 
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33.3. The Output Writer 

An output writer is a spooling facility that is responsible for printing and punching 
spooled output from a job. Under normal processing conditions, an output writer loads 
automatically and is transparent to a user. When it processes output, it does so 
according to specifications set at SYSGEN time. 

You can, however, manually load an output writer from your workstation. By 
manually loading an output writer, you can control its mode of operation and its 
processing criteria. The following function codes are used with the PR/PU and RP 
spooling commands to control the output writer. See the formats for these commands 
(3.3.4 and 3.3.5) to leam which function codes are valid under which circumstances. 

Function Codes for the Output Writer 

f BURST 1 

Places the output writer in burst mode. In burst mode, output files are available 
for processing before a job has terminated. The output writer writes an output 
data file as soon as the job step that created the file is completed. If BX is entered 
with file modifiers (3,3.2), the output writer terminates after processing all files 
that satisfy the modifiers. If BU is entered, the output writer requests another 
function when more files exist that do not satisfy the modifiers. 

BYPASS 

Terminates processing of the current file. The current file is closed and the output 
writer continues processing the next file. Bypassed files can be restarted later. 

COPIES,nnn 

Sets the number of copies the output writer produces for each file it processes. 
You can specify from 1 to 255 copies (nnn). If you do not specify a number, one 
copy is assumed. The file is closed when processing is completed. 

DELETE 

Deletes the file being processed and proceeds with the next file to be processed. 

DEVICEE.did] 

Changes the device the output writer is currently using to print or punch its 
output. If a new device (did) is identified in the function code, that device is 
allocated to the output writer, and the current device is deallocated. 
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DISPLAY 

Displays the status of the current file on the workstation screen. The information 
displayed is: 



File name 

Job name 

Current page (card) number 

Total pages (cards) in file 

Program name 

Job step number 

Number of remaining copies 

Existence of a breakpoint 



HALT 



Terminates the output writer after the current file (if any) is processed. If the file 
being processed has multiple copies, the remaining copies are produced when the 
output writer is reloaded. 



HOLD 



Places the current file in a hold state and begins processing the next file. Files in 
a hold state are not available for processing until released by the BEGIN 
command. 



jNPUT^didE.B] 



'P 



Directs the output writer to accept input from the tape, disk, or diskette unit (did) 
identified in the function code. This function is used to reintroduce redirected 
output so that it may be printed or punched. If the input is from disk or format 
label diskette, the B option permits specific files to be selected. The RET option 
specifies that redirected output (print or punch) is retained after processing. The 
REL option allows you to release these retained subfiles. 



NBURST 



Places the output writer in nonburst mode. If specified while the output writer is 
processing a file, the function does not take effect until file processing is 
completed. 
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RETAIN 



Retains the currently active file in a HOLD state in the spool file after it is 
processed. The retained file is unavailable for additional processing until released 
via the BEGIN command. (Otherwise, delete the retained file via the DELETE 
command.) 



RESTART 



,PAGE,nnnn 



[ ,CARD,nnnn 

Restarts processing of the currently active file fi-om a number of pages or cards. If 
no number is specified, the output writer restarts processing from the beginning 
of the file. If only nnn is entered, file processing is restarted nnn pages or cards 
back fi-om the current position of file. If PA or CA is entered with nnnn, the file is 
positioned back to the page or card identified by nnnn. 

RESTART J ,nnn ] 
I , LI, nnn J 
Restarts processing at nnn lines from the current position or at the line number 
indicated by LI,nnn in the log file being processed. 



SD 



Used for debugging purposes only. If specified, the message ENTER SPOOL 
DEBUG COMMAND is displayed. Enter a debug command (ALL, LOG, PRINT, 
or RDR) to print the directories of the various spool file queues. When printing is 
completed, the ENTER SPOOL DEBUG COMMAND is displayed again. Enter 
another debug command or enter HALT to terminate spool debug. 



SKIP 



SKIP 



J PAGE, nnnn 
J CARD, nnnn 

directs the output writer to skip forward nnnn number of pages or cards, or to 
skip forward to a specific page number (FAGE,nnnn) or card number 
(CARBfnnnn). After positioning, a request is made for another function. 

J '""" 1 
\ , LI. nnn J 

Directs the output writer to skip nnn lines from the current position or to skip to 

the line number indicated by Ll.nnn in the log file being processed. 



STOP [, PAGE] 

Directs the output writer to stop processing. If PAGE is omitted, the output 
writer terminates immediately. If PAGE is included, the output writer 
terminates after printing the complete current page. The file being processed is 
closed but not deleted. When accessed by another output writer, the file is 
processed fi-om the point at which it was closed. 
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3.3.4. Manually Loading an Output Writer (PR/PU/PD) 

The PR/PU/PD spooling command allows you to manually load an output writer to 
print (PR), puncli (PU), or process diskette (PD) spooled files associated with your job. 
Normally, the output writer is loaded automatically to process the output files fi-om 
your job. However, under certain circumstances, you might choose to load an output 
writer yourself. In doing so, you can also control output processing by specifying 
function codes. 

FR^U/PD is useful when, for example, your output writer normally operates in 
nonburst mode and you need an output file printed or punched before your job has 
terminated. In nonburst mode (a SYSGEN option), the output writer won't write an 
output data file to a device until the job that created the file has terminated and the 
job's header and log have been written. 

You can also use PR/PU/PD to print or punch spooled files that were recovered after 
a "warm" start. It is important to note, however, that if a device hardware error occurs 
while your files are being printed or punched, it is up to you to resume processing. 
"When a hardware error occurs, the following message is routed to your workstation: 

nn sym-id f PR 1 (did) UNRECOVERABLE OUTPUT ERROR, ENTER I OR FUNCTION. 



■id J PR 1 (did) 
|PU| 



did is the device address of the printer or punch where the error occurred. To ignore 
the error, key in I as a solicited response. Otherwise, enter an output writer function 
code (3.3.3) like STOP or RESTART. No did is needed if PD is used. Diskette files 
are written in data set label mode to the location on the diskette defined in the job 
control device assignment set. 



Foi^iat 



PR 

PU 
PD 



A[funct1on-code3C,ACCT=acctno][,BNUMB=binary-jofcno][sCART=cartridge-name] 
[ , nLE=f 1 lename] [ ,FORM-f0rmname] [ , J0B=joi3nare] 



Parametei^ 

function -code 

Specifies the output writer's mode of operation and processing criteria. If a 
fimction code is omitted, the output writer is loaded in the mode 
(burst/nonburst) indicated at SYSGEN. See 3.3.3 for a complete list of output 
writer fiinction codes. The BU and BX fimction codes allow you to change the 
output writer's mode of operation. The first time you issue the PR, PU, or PD 
spooling commands during one workstation session (fi-om logon to logoff), BU 
and BX are the only valid function codes you can choose. Once the output 
writer starts printing or punching, you can enter the commands with any 
other function code to change the output writer's processing criteria. 

Note: Function code keyins cannot exceed 28 characters in length, including 
commas. 
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Examples 

PR BX,FO=MYFORM 

The output writer is loaded in burst mode to group all spooled output files associated 
with the form name specified and then print the groups on a first-in, first-out basis. 
The output writer terminates when all form name file groups have been printed. 

PU BU,JO=MYJOB 

The output writer is loaded to process, in burst mode, all punch files created by 
MYJOB. 

3,3.5. Manually Loading an Output Writer to an Auxiliary 
Printer |RP1 

The RP spooling command allows you to manually load an output writer to print to an 
auxiliary printer. The auxiliary printer can be connected to either a local or remote 
workstation. 

In many cases it's not necessary for you to use the RP command to load an output 
writer to an auxiliary printer. Normally, your system loads it automatically, as long as 
you've generated your system to use auxiliary printers and directed your print files to 
an auxiliary printer prior to the time your system prints your print files. See Spooling 
and Job Accounting Operating Guide, 7004 4581 for more information on use of the RP 
spooling command. 

You direct your print files to an auxiliaiy printer in one of two ways, depending on 
what t3npe of program or job you're working with. If you're running an interactive 
system program, such as EDT, direct your print files to an auxiliary printer through 
the interactive services SCREEN WKSTN command. If you're running your own jobs, 
direct your print files to an auxiliary printer through job control. 

In some cases, however, manually loading an output writer to an auxiliary printer 
using the RP command is not only desirable but necessary. The RP is necessaiy when 
you've directed any of the output files from your jobs to another user's workstation 
auxiliary printer. In other words, you included another user's identification on either 
the // OPTION OUT or // ROUTE statement in the job control for your job. Here, the 
other user must issue an RP command to start the printing of your files. Printing in 
this case is not automatic. (Similarly, if you are not the initiator of a job, but output is 
directed to your auxiliary printer, you must issue an RP command to start printing. To 
find out whether any output files have been routed to your user-id, use the DISPLAY 
SPL command.) 
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You can also use the RP command when: 

• Your output writer normally operates in nonburst mode, and you need an output 
file printed before your job terminates. In this case, you could manually load an 
output writer to your auxiliary printer. 

• You want to recover output files after a warm start or to resume printing after an 
auxiliary printer hardware error, 

• You want to control an output writer's processing criteria by specifying function 
codes with the command after the output writer has begun printing. 

• You need to issue an interactive services SCREEN WKSTN command at a 
workstation that is not connected to an auxiliary printer; then issue either a 
PRINT command or an EDT LIST command. In this case, you must: 

1 . Log off that workstation 

2. Log on imder the same user-id at the workstation that is connected to an 
auxiliary printer 

3. Issue an RP command 

These actions cause your system to print the print files fi^om your interactive 
system program sessions at your auxiliary printer. Only by performing all three 
actions can you get your print files printed at the auxiliary printer. 

In all eases, remember that the RP command does not work independently; to use the 
RP command, you must have generated your system to use auxiliary printers and 
directed your print files to an auxiliaiy printer prior to the time your system prints 
your print files. 

Notes: 

1. The 11 ROUTE and / / OPTION OUT statements have additional DDP 
parameters not discussed here. You cannot use RP to direct printing to a DDP site. 
RP applies only to auxiliary printers connected to local or remote workstations. 

2. Output files that you direct to an auxiliary printer can be secured or unsecured. If 
a file is secured, the user the output is directed to must be logged on for printing to 
begin. Secure a file via the 1 1 SPL statement orjproc. See the Job Control 

Programming Guide, 7004 4623, for details. 

3. DDP or auxiliary printer output (via / / ROUTE) and RBP output (via 1 1 DST) 
cannot be mixed for any one job. DDP and local printer destinations cannot be 
used for the same print file. 



UP-9972 Rev. 2 3-27 

Update B 



General Workstation Commands 



Format 

RPAEfunct ion-code] E,ACCT=acctno]E,MUHB=binary jobno][,CART-cartridge-name] 
[ , n LE=f i lenane ] [ , FORM=sf ormname] [ , JOB= jobnane] 

Parameters 

function code 

Specifies the output writer's mode of operation and processing criteria. If a 
function code is omitted, the output writer is loaded in the mode 
(burst/nonburst) indicated at SYSGEN. See 3.3.3 for a complete list of output 
writer function codes. The BX function code lets you change the output 
writer's mode of operation to nonburst mode and is the only valid fimction 
code the first time you issue the RP spooling command during one 
workstation session (from logon to logoff). Once the output writer starts 
printing, you can enter the RP command with any other function code to 
change the output writer's processing criteria. 

Examples 

RP BX,JO=MYJOB 

In this example, an output writer is loaded to print to an auxiliaiy printer in burst 
mode to process the output data files from the job MYJOB. 

The following conditions could cause this command to be rejected: 

• Incorrect S5mtax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered, 

• Output Not Destined for an Auxiliary Printer 

You cannot direct output to an auxiliary printer unless output was destined for it 
via job control. 
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3.3.6« Obtaining Spooled File information 

(DISPLAY ACT/SPL/CNSLG Commands) 

The DISPLAY commands let you obtain information about either spooled files being 
created by the program (DISPLAY ACT) or completed spooled files (DISPLAY SPL). 
You can also use DISPLAY to cause a console display of the number of lines that have 
accumulated in the current console log subfile (DISPLAY CNSLG). All formats of the 
DISPLAY command function in a similar manner and produce similar displays. They 
enable you to obtain information, such as the name of the job creating the file or files, 
number of pages or cards created, and the number of copies of the file to be produced 
upon output to the printer or pimch. You can only display information about files used 
by jobs created by your user-id, unless you have been given global status privileges by 
the system administrator. 

DISPLAY ACT Format 



DISPLAY ACT 



DDPPR 
DDPPU 
PRIMT 
PUNCH 
RBPPR 
RBPPU 



[.modifier- 1 , . . . ,modif ier-n] 



DISPLAY SPL Format 



DISPLAY SPL 



DDPPR 
DDPPU 
LOG 

PUMCH 
RBPPR 
RBPPU 

RBPI^ 
RDR 



C,modifier-1,...,modifier-n] 



DISPLAY CNSLG Format 

DISPLAY CNSLG 

Notes: 

1. The positional parameters for the DISPLAY commands are described in more 
detail in the Spooling and Job Accoimting Operating Guide, 7004 4581. 

2. If you do not enter a directory for the DISPLAY ACT and DISPLAY SPL 
commands, all directories are displayed. 

3. Do not use modifiers with DISPLAY CNSLG; if entered, the command is ignored. 
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The DISPLAY SPL and DISPLAY ACT commands display information in a series of 
single lines. The first display line gives you a list of the number of files the system has 
found meeting your requirements, the number of pages produced, and the number of 
card images produced. For DISPLAY ACT^ these totals represent files currently being 
created; for DISPLAY SPL, they represent the completed files. The first display is as 
follows: 

24 DI1642 DI01 status FILES=ffff PAGES=ppppp CARDS=ccccc 

where: 

status 

Specifies whether the line is displa3dng a list of files QUEUED, in the HOLD 
state, or IN-PROGRESS being processed by the output writer. If RDR is 
specified as the spool queue, IN-PROGRESS specifies that files are being 
processed by programs. 

fffff 

Represents the number of files. 

PPPPP 

Represents the total number of pages. Log files are not included in the page 
count. 



Represents the number of card images. 

This display is produced for each of the three statuses containing one or more files. If 
there are more than one, the system displays them to you one at a time. You must 
press the XMITkey to view the remaining displays. 

After you have seen these displays, the system asks you if you want to see further 
details of the spooled files requested in your DI ACT or DI SPL command. If you enter 
a DI ACT command, the following line is displayed: 

257DI1642 DI02 SPOOL FILE DETAILS? **n,M,*** 
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If you. enter a DI SPL command, the following line is displayed: 

267DI1642 DI02 SPCML FILE DETAILS? ***Y,H,Q,H,I ,S,SQ,SH,SI*** 

where: 

Y 

Specifies that the system displays all spooled file details. 



Specifies that the display should not be continued; no spooled file details 
should be displayed. 



Specifies to display all queued files. 
Specifies to display all files being held. 



Specifies that all files currently being processed by the output writer be 
displayed. If RDR is specified as the spool queue, I specifies that all files 
currently being processed by programs be displayed. 



Specifies that you want to see an abbreviated display of all files. 

SQ 

Specifies that you want to see an abbreviated display of all queued files. 

SH 

Specifies that you want to see an abbreviated display of all the files being 
held. 

SI 

Specifies that you want to see an abbreviated display of all files in progress. 
You respond by ke3ring in one of these nine choices. 
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If you respond with N, the display and command terminate. If you respond with Y, Q, 
H, or I and specify a queue other than RDR, the system displays the following: 



24 DI1642 


DI04 


JOBNAME jobnane FILE filename STATUS file status 


25 DI1642 


DI05 


TOTAL f PAGES " 
• CARDS 
. LIMES . 


nnnnn REMOTE- ID xxxxxx COPIES nnn 


26 DI1642 


DI06 


STEP -NUMBER nnn DEVICE -TYPE xxxxx BREAKPOINT J Y ] 

' ^ J 


27 DI1642 


DI07 


BAND -NAME xxxxxxxx FORH-name xxxxxxxx ACCT xxxx 


28 D 1 1642 


DI07A 


JOB-lilAME nnnnn 


29 DI1642 


DI08 


PROGRAM -I^AME xxxxx 


30?DI1642 


DI12 


COMTII^UE? **' 


f,m* RESTART? **R** 



If you respond with Y, Q, H, or I and specify the RDR queue, the system displays: 



31 D 1 1642 DI09 RDR FILE nnnnn CARDS LBL xxxxxxxxxxxxxxxxxx VOL wvw 
32?DI1642 DI12 CONTINUE? *n,M** RESTART? **R** 



Note: The VGL display appears only when the RDR file is spooled in from a 
diskette. 



where: 



JOBMAME JobnaBe 

Is the name of the job that created the spooled files. 

FILE filenaiie 

Is the name of the file whose characteristics are being displayed. 



STATUS 



Is the status of the file whose characteristics are being displayed (QUEUED, 
HOLD, IN~PROGESS). 



TOTAL PAGES 
I CARDS 

[ LIMES 

Is the total number of pages, cards, or lines. 
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REMOTE- ID 

Is the user-id of the workstation from which the job producing the spooled 
output was initiated. 

COPIES nnn 

Is the number of copies of the file to be made when it is transferred to the 
output device (printer, punch, etc.). 

STEP -NUMBER nnn 

Is the number of the job step within the job specified by the job name. 

DEVICE -TYPE XXXXX 

Is the type of output device the file is sent to (printer, punch, etc.). 

BREAKPOINT 

Informs you whether or not the file has been breakpointed. 

BAND -NAME xxxxxxxx 

Is a name given to the print band to be used by the printer that prints the 
file. For example, a band name of 48-BUS. would indicate the printer is to 
use a 48-character standard business print band. Band names are initially 
specified at SYSGEN time. This name is the same as the cartridge name 
that you specified. 

FORH-NAME 

Is the name of the form used on the printer, 

ACCT xxxx 

Is the account number of the job that created the file. 



VOL 



LBL 



Is the volume serial number of the diskette read from. 



Is the label of the diskette read from. 



These lines of information are displayed one at a time, and you must press the XMIT 
key after each line is displayed, to view the next line. If you respond to CONTINUE? 
(message DI12) with Y, the displays continue with other files. If you respond with N, 
the display terminates. DI12 also offers a RESTART option that redisplays the 
SPOOL FILE DETAILS message (if DI SPL was entered) or the ACTIVE FILE 
DETAILS message (if DI ACT was entered). 
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If you respond to the SPOOL FILE DETAILS message (DI02) with S, SQ, SH, or SI, 
the following is displayed: 



33 DI1642 DI11 JOB=jobnaiTte PROG=pr©gnanie FO=fonmame [ PA 

CA 
LI 



=nnnnn ST-stepnumber 



Note: ST=stepnumber indicates the step number of the job that created the file. 

The system produces 19 Dill lines on the screen (or however many, up to 19, needed 
to display information for files that fit your criteria) and then asks you if you want to 
continue: 

347011642 DI12 COMTIMUE? *n,N** RESTART? **R** 

Your entry of Y continues the display. An entry of N terminates the display. 

If you respond to the SPOOL FILE DETAILS message (DI02) with S, SQ, SH, or SI 
and the RDR directory was specified, the following display is produced: 

35 DI1642 DI09 RDR FILE nnnnn CARDS LBL xxxxxxxxxxxxxxxxxx VOL VWW 

The system produces up to 19 DI09 lines and then asks you if you want to continue 
by displaying the following message: 

367DI1642 DI12 COMTINUE? **y,IJ** RESTART? **R** 

Note: The VOL display appears only when RDR file is spooled in from a diskette. 

If no files exist that fit the criteria you entered with the command, the system displays 
the following: 

37 DI1642 DI03 ^0 SPOOL FILES FOUMD 

Example 

DI SPL, PR,FILE=JOBCOST 

This example causes the display of information about a completed file named 
JOBCOST residing on the printer spool queue. 

The following condition can cause this command to be rejected: 

® Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 
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3.3.7. Holding Spooled Files {HOLD SPL/ACT/SPQ Commands) 

The HOLD commands let you place spooled files in a "hold" state. In the hold state, 
the files are unavailable for processing. To make them available, you must release 
them by using the BEGIN command (3.3.8). You can place only completed spooled files 
in the hold state from the workstation, and you can hold only those files created by jobs 
running under your user-id, unless you have been given global control privileges by the 
system administrator. 

Format 1 



HOLD SPL 



DDPPR 

DDPPU 

LOG 

PRIMT 

PUNCH 

RBPPR 

RBPPU 

RDR 



[,modif ier-1j...jniodif ier-n] 



Format 2 



HOLD 



{q 



[ iiii 

LOG 

EEJNT 

EINCH 



The positional parameters for the HOLD command are described in more detail in the 
Spooling and Job Accounting Operating Guide, 7004 4581. 

When you enter the HOLD SPL or HOLD SPQ command, the following message is 
displayed: 

45 H01234 HO01 xxx. SPOIL FILES HELD 

where: 

XXX 

Is the number of spooled files held by your command. 
Example 

HO SPL,PRIHT,CART-48-SCI 

In this example, all print spooled files that require the use of a 48-character scientific 
print cartridge are held. 
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The following condition could cause this command to be rejected: 

• Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 

3„3.8. Releasing Held Spooled Files (BEGIN SPL/ACT/SPQ Commands) 

The BEGIN command lets you release spooled files being held by a HOLD command. 
This command can release completed spooled files and spooled files held by the //SPL 
job control statement. This command loads and places the output writer in burst 
mode. However, an output writer called in burst mode fi*om a workstation does not 
take over the printer. It waits its turn for the printer and then prints the files 
specified. You can release only those files created by jobs running under your user-id, 
unless you have been given global control privileges by the system administrator. 

If a job is initiated from a workstation and the spool file is destined for an auxiliaiy 
printer connected to that workstation, this command loads the RP output writer in the 
burst mode for the files associated with the user-id. The RP output writer is loaded 
according to the parameters entered in the BEGIN command when the spool file is 
released. 

Foi'mat 1 



BEGIN SPL 



DDPPR 
DDPPU 

LOG 

ERJNT 

PUNCH 
RBPPR 
RBPPU 

RDR 



C,m©difier-1,...,iiiodifier-n] 



Format 2 



BEGIN SPL, 



LOG 

PRIMT 

PUNCH 



1 [,modffier-1,.,.,modifier-n],0UT-J did 1 
I 1^^ J 



Format 3 



BEG 



IN J ACT 1 

IspqI 



LOG 
P£INT 
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The positional parameters for the BEGIN command are described in more detail in 
the Spooling and Job Accounting Operating Guide, 7004 4581, 



Note,' The OUT parameter is used only with the BEGIN SPL command. You use it 

to specify the designated device that the output is to be printed on (did) or to 
specify that the output writer is not to be loaded. IfOUT=did is specified, ALL 
or RDR cannot be specified as the directory. OUT^id can only be specified 
for the log, print, or punch queues. IfOUT=NO is specified, the command 
keyin can be up to 60 characters in length, including commas. 

When you enter the BEGIN SPL command, the following message is displayed to you: 

46 BE1234 BE01 xxx SPOOL FILES RELEASED 

where: 



XXX 



Is the number of spooled files released by your BEGIN SPL command. 



Note: The action taken when a BE SPL command releases a held spool subfile 
destined for an RP output writer can be as follows: 

• The console releases the file from the held state, but does not call an 
auxiliary output writer. 

® The workstation initiating the job without an auxiliary printer 

physically attached calls an RP output writer, but cannot print the file. 

® The workstation initiating the job with an auxiliary printer physically 
attached prints the job. 

• The workstation specified in 1 1 ROUTE calls an auxiliary output writer 
and prints the file. 

• Calling BE SPL from workstations other than the one specified in the 1 1 
ROUTE calls an auxiliary output writer, but the file is not printed. 

® Loading a burst output writer after a BE SPL command prints any 
subfile with the user-id matching the selected criteria. 

Example 

BE SPL,PRIMT,CART=48-SCI 

In this example, print files requiring a 48-character scientific print cartridge, which 
had been held (see the example of the HO SPL command in 3.3.7), are released. 
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The following conditioo could cause this command to be rejected: 

® Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 

333. Deleting Spooled Files {DELETE SPL Command) 

The DELETE SPL command enables you to delete spooled files from spooled file 
directories. You can delete only completed files, that is, those that are not being 
processed by an output writer or user program. You can delete only the files created by 
jobs running under your user-id. 

Format 



DELETE SPL, 



ALL 
DDPPR 
DDPPU 
LOG 

PUNCH 
RBPPR 
RBPPU 

RDR 



[,modifier-1,...,moclifier-n] 



The positional parameters for the DELETE SPL command are described in more 
detail in the Spooling and Job Accounting Operating Guide, 7004 4581. 



Note: There is no default value for spool directories in this command. You must 
enter a directory. 

When you enter the DELETE SPL command for a complete directoiy or ALL is 
specified, the following message is displayed: 

DE05 DELETING ENTIRE xxxxx QUEUE. CONTINUE (Y,M) 

where xxxxx is the name of the queue to be deleted. This message acts as a precaution 
against deleting the entire spool file or a particular queue in the event that an error 
was made in the command keyin. 

Enter Y if the command keyin is correct; enter N if it is incorrect. 
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If Y is entered, the spool subfiles are deleted and the following message is displayed: 

DE01 XXX SPOOL FILES DELETED 

where xxx is the number of spool files deleted. 

If N is entered, the spool subfiles are not deleted and the system displays a DEOl 
message which indicates that no spool files were deleted. 

Example 

DE SPL,PRIMT,CART™48"SCI 

In this example, all print spooled files requiring the use of a 48-character scientific 
print cartridge are deleted. 

The following condition could cause this command to be rejected: 

® Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 
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3.3.10, Changiog Device Type and/or tfie Number of Copies for 
Spooled Files (CH SPL Command) 

You use the CH SPL command to alter the device type and/or the number of printed 
copies of a spooled file. The parameters changing the copies and/or devices are 
required since there are no defaults. You can change the device type and for the 
number of copies for spooled files created by jobs running under your user-id only, 
unless you have been given global control privileges by the system administrator. 

Format 



CHANGEASPL, | ALL 
I LOG 
PRINT 



[.modifier- 1 ... modifier-n] C,COPIES=nnn] 



,DVC^ 


■ 77% 
776 
789 

PPC 

9246 






9215 
AMY 
CLASS 1 
CLASS2 
CLASS3 
. AUX 




L 




J 



,DVC=AUX, 



,!D=r* I ,iD=r* I 

I user- id j | user- id j 



This command changes closed spool subfiles of either queued or held status, but not 
subfiles of active status. 

f 
Parameters 



ALL 
LOG 
PRINT 

Specifies the directories you want to change the device type or number of 
copies for. ALL includes LOG and PRINT queues only. 

[modifier- 1 ... modifier-n] 

Uses any of the modifiers listed for the spool command. By leaving criteria 
blank, you base the search for spool files on the user issuing the command. 
(See section 3.3.2 for the list of modifiers.) 

COPIES=:nnn 

Number of copies can be between 1 and 255. 
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DVC:= 



778 

776 
789 
PPC 

9246 

9215 

ANY 

CLASS 1 

CLASS2 

CLASS3 

AUX 



Spool parameters are not hard-assigned to a device specified on the DVC 
parameter, but logically assigned to a device type. Using the DVC parameter 
permits you to logically switch the files spooled to print on another device or 
class of device. 

DVC=Aux,iD== r * I 

[ user- id J 
This parameter enables printing on an auxiliary printer of the user-id. The 
system displays an error message if the user-id is not specified with this 
parameter. 

iD= r * I 

I user- id J 
Use this parameter to specify a change of user ownership. 

When you enter the CH SPL command, the following message is displayed: 

CH01 nnn SPOTL FILES CHANGED 

where: 

nnn 

Is the number of spooled files changed by your CH SPL command. 

Examples 

CH SPL,ALL,DVC=PPC 

This example sends all log and print files for the user to the device type PPC printer, 

CH SPL , ALL , JOB=TEST , DEV=770 , DVC-PPC 

This example changes only the files originally destined for the 770 printer. (The 
original JCL indicated by DVC 28.) It directs the spooled files to a PPC. 
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CH SPL,ALL,J0B=Y0URJ0B,DVC=CLASS2 

This example redirects all spooled output to a class 2 PPC printer. 

CH SPL,ALL,JOB=YaJRJOB,DVC=ANY 

This example enables printing of spooled files on any printer. 

CH SPL,ALL,JOB-MYJOB,DVC=AUX,ID=* 

This example redirects the spooled output to the aux-printer attached to the current 
workstation/terminal. The original spool file could have been created without using 
the // ROUTE in the // DVC 20 // LFD sequence for the printer. 

CH SPL,ALL,JOB=MYJOB,DVC=AUX,ID=YajRID 

This example redirects the spooled output to the aux-printer attached to the 
workstation/terminal of the user indicated by the parameter ID=. The original spool 
file could have been created without using the // ROUTE in the // DVC 20 // LFD 
sequence for the printer. 

CH SPL,PR,J0B-MYJ0B,C0PIES=2 

This example changes the number of copies requested for one or more spooled files 
currently queued or on hold. This overrides the number of copies specified in the JCL 
statement. 

The following error condition causes the CH SPL command to be rejected: 

• Incorrect Syntax 

The command was misspelled or ambiguous, or the command parameters were 
improperly entered. 
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3»3.11. Breakpointing Spooled Files (BRKPT Command) 

The BRKPT command enables you to close one or more files and make them available 
to an output writer for printing or punching. The remainder of the file created after 
you enter the BRKPT command is placed in a new file. You can breakpoint only the 
files created by jobs running under your user-id, unless you have been given global 
control privileges by the system administrator. You cannot breakpoint files that are 
placed on a diskette. 

Format 1 

BRKPTA f P ] , f PR ] [,J0B-jobname]C,modifier-1,...,ii»difier-n][,H0LD] 



Format 2 



,ajT= 



TAPE 
DISK 

DISKETTE 



[,H0LD3 



BRKPT CNSLG 

Parameters 

p/i 

Specifies whether you want to breakpoint the file immediately (I) or at the 
end of the currently completing page (P). If, through the next parameter, you 
specify that you want to breakpoint a file for punching, the file is 
breakpointed immediately, whether you specify F or I. 

PR/PU 

Specifies the type of file you want to breakpoint. PR indicates you want to 
breakpoint a printer file; PU indicates you want to breakpoint a punch file. 

CMSLG 

Indicates that the console log subfile is to be breakpointed. 

When you enter the BRKPT command, one of the following messages is sent to inform 
you of the status of your command: 

42 BR1132 FILE filenane FOR JOB jobname HAS BEEN BREAKPOINTED 

This message indicates that your breakpoint has been successful. 

43 BR1132 FILE fUename FOR JOB jobname UNABLE TO BE BREAKPOINTED 

This message indicates that an FO error has prevented successful breakpointing of 
the job. 



UP-9972 Rev. 2 343 

Update B 



General Workstation Commands 



44 BR 1132 JOB NAME NOT SPECIFIED FOR BREAKPOINT 

You did not enter a job name as part of the BRKPT command. Breakpoint cannot be 
done without a job name. 

45 BR1132 BREAKPOINT REQUEST INVALID 

You attempted to breakpoint a RDR file, or a file created by a job running under 
another user-id. 

46 BR 1132 FILE NOT AVAILABLE FOR BREAKPOINT 

The system is not able to find the file specified to be breakpointed. 

47 BR 1132 BREAKPOINT ALREADY IN PROGRESS FOR JOB jobname. 

A previously entered breakpointing operation is in progress involving the job you want 
to breakpoint. Your breakpointing operation cannot begin until the previous operation 
has completed. 

48 BR1132 JOB HOT AVAILABLE FOR BREAKPOIMT 

Either the job you want to breakpoint is not in the system or is running under Data 
Base Systems^ a data base system developed by Unisys for European users. 

Example 

BR I,PU,JOB=HYJOB 

In this example, a punch file currently being created by the job named MYJOB is to be 
breakpointed. 

The following condition could cause this command to be rejected: 

• Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 
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3 A, Commands to Control Workstation Logging 

Use the following commands to control the process of workstation logging. 
Workstation logging automatically creates a record of all the system commands issued 

from your workstation, system messages sent to your workstation, and the responses 
you make to those messages. If you want it to include commands entered in 
workstation mode also, you can specify that with the LOG parameter of the SCKEEN 
command (3.2,8). The record created is a workstation log file; it begins when you log on 
the workstation and ends when you either log off the workstation or breakpoint the log 
file for printing. Workstation logging is available if console logging (CONSOLOG 
parameter) is configured when your system is generated (SYSGEN). Workstation 
logging is available to both locally connected workstations and remote terminals 
acting as workstations. When you log on, use the LOG parameter of the LOGON 
command to specify whether the workstation log file is to be printed. See 1,3.2 for 
complete information on the LOGON command. 

3.4.1. Breakpointing Workstation Log Files 
{BRKPT LOG Command) 

The BRKPT LOG command enables you to close the workstation log file and make it 
available to the output writer for printing before you log off the workstation. A new 
workstation log file is started with the first message or command after the BRKPT 
LOG command is entered. The new workstation log file continues until it too is 
breakpointed, or you log off the workstation. 



Format 



BRKPTALOG 



,aJT= 



DISK 

DISKETTE 



[.HOLD] 



Parameters 



OJT- TAPE 
DISK 

DISK ETTE 

Indicates where you would like to redirect the contents of your log. If you 
choose DISKETTE, it must be a format label diskette. 

Permits a log file to be held after the breakpoint has occurred. 



HOLD 
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If your BRKPT LOG command is accepted, you receive the following message: 

31 BR483 BREAKPOINT TAKEN FOR WORKSTATION LOG yy/nro/dd USER=xxxxxx 

where: 

xxxxxx 

Is your user-id. 

If the BRKT LOG command is rwt accepted, you receive the following message: 

32 BR483 WORKSTATION LOGGING NOT ACTIVE 

This indicates that you did not specify that the workstation log was to be printed when 
you logged on, or that console logging was not specified at SYSGEN. 

If an error occurs while the breakpoint is being taken, you receive the following 
message: 

33 BR483 BREAKPOINT ERR WORKSTATION LOGGIMG SUSPENDED 

Contact your system administrator if you receive this message. 

If you specify anything other than TAPE, DISK, or DISKETTE for the OUT 
parameter, you receive this message: 

34 BR483 BREAKPOINT ERR- INVALID OJT PARAMETER 
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The following is a sample printout of a breakpointed workstation log: 



L060N 

II L060MQ0P ISIf L060N ACCEPTED AI 16s2%:18 

T2 LOSOWOOB IS2I TODMS ByLLETIM ISs 

*«*«***«**^*««4r**« yELCOME TO OS/ 3 



73 LOeOMOOi 
7^ L06®li00P 
75 LOGONOOl 

16 iEFMEOO* 

17 DEFKE30P 



0^ 8I/03/l?t RE« ll^O^OSl 



^*###»*##»««#*##*« 



IS90 DEFKEf 
ISfO DEFKEY 

78 DEFMEOOP IS90 OEFKEY 

79 DEFMEOOi IS90 OEFMEY 
SO DEFREOOi IS90 DEFKET 
61 DEFKEOOf IS90 DEFKEY 

82 DEFKEOOf IS90 OEFKEY 

83 OEFMEaOf IS90 DEFKEf 
a^ DEFKEOOB IS90 DEFKEf 



yELCOHE T© 'H0D8 SfSTEM HIO * 

THIS LE¥EL ll«OsSl«l CREATED 03/15/81 

COMMAND TERMINATED NDRMiLLY 

COMHiNO TERMINiTEO HORMULL^T 

CONHiMD TERMI^iTED NORMALLY 

COnmUD TERHWiTED TORM^LLl 

conmuo termimiteo munkLLX 

COnmnO 1ERM1M*IED NDRMiLLX 

cmmun termimited n3rhall.y 

COMMAM0 lERHIMiTEO ^3RMIILL^ 

COMHA^D TERMINiTEO mUHkLLy 

COnnkHD TERMIMiTED N3RMILLt 

COHMiND TERMlMiTED M9RHILL1 



no JOBS FOUND 

♦^♦♦«»##*«#*»#«*## ¥T0C OF ¥OLU^E ^UHLIB tt»«t:#**^#»^«»«#^«# 



T¥PE EXT CYL XDIR tD*I* «THIRO ifllLi. 



S5 OEFKESOi IS90 OEFKEY 

8i SCREE3iS IS90 SCRFEN 

01 JS 

S7 010773 

¥T UUM 

88 fT0C039 

89 iT0Ca39 

90 iT0C009 

91 ¥T©C0D9 

92 iT0C0Q9 S¥TOC HIR*H 001 001 

93 ¥T©C009 SfSRUNICSEREDT SAl 001 001 
f% WT0COO9 STSMUMDF-EFK S^T 001 001 

95 iTOC009 SYSRUMCPREP S^T 0Q| 001 

96 ¥¥©€009 DHPS00722IM?BRt MIRiM 001 001 

97 ¥TaCQDf fliRU>IIM7BRt SAT 001 001 D 
9a ¥T©CQ09 STSRUNIKBMRB SIT 001 QOI 
99 WT0C009 SfSRUMEXTAJ S^T 002 002 

11 iT0£0a9 STSRUMEXSiL SAT 001 001 

12 iT©C009 JfSRUMEXSKLl SAT 003 0Q3 110 

13 MT0CO39 SYSRUMEMBJl SAT 00? 0D5 110 
m MT0CQQ9 ffSRUMEXSKLS SAT 002 I3C3 110 

15 MTOC009 ffSRU^AOeUST SAT ' QOI 001 

16 WT0C009 SfSRUMMOCOOE SAT 001 001 

I? wTocaof 

18 ¥TOC009 «♦ TOItL FREE: CYLIMDERS 603^ TRACKS 031 ON VOLUME RUNUB <«♦ 
FS S«fS6iL0OtRES 

19 FSTIfOOf L-SesSZEOO L-SSCMCTOO BL-S3CMFB00 

20 FSliI309 IS83 rST«fUS FH^ISHED® 00003 ELEMENTS HERE OISPLiYED 
DI SFL 

21 OIOII? 0103 SP0OL FILE EMPTY 

22 010??? Oil* DI SFL COMPLETED 
BR LO 



lbt2^% 


IBsmt 


16s2«lii 


ibiznz. 


ia:2«is 


16t2%s, 


IblZHz 


ibzzm 


IbiZkz 


16s2%s 


ISs2%s 


lb:m% 


IbsZnz 


I6:2%i 


IbzZHz 


16t2*s 


I6;2%s 


16:2%s 


16i2*s 


I6l2«is 


lis2«ls 


I6s2^s 


lfes2%s 


16s2%s 


lbs2*^% 


%hzm% 


16t2*s 


16s2^i 


16:2%s 


16:28|s 


16t2^s 


1612^1 


1SS2*; 


lS:2^s 


1S:2^! 


16s2sis 


I&r2«i5 


ihtznt 


ihzznz 


16s2%s 


IhzZSi 


|6s2Ss 


Ifes25s 


1SS25S 


16S25S 


I6s25s 


16S2SS 



sl3 

219 

122 
s22 
s22 
s22 

sZi 
:2^ 
s26 
i;2S 

S26 

zn 

12? 
!2? 

s2I 
tZB 
S3? 
s3E 

mb 
zm 

z%7 
S%S 
tHB 

%^6 
%nB 

ZHB 
l48 
S«I8 
%H6 

s^i 

s^8 

s^e 
s^e 

sOI 

Sl«l 

sl^ 
sif 
s2% 
s2^ 
s29 



The following condition could cause this command to be rejected: 
• Incorrect S3mtax 

The command was misspelled, not entered correctly, or entered with parameters 

attached. 
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3A.2. Obtaining Workstation Log Information 
(DISPLAY LOG Command} 

The DISPLAY LOG command gives you a one-line report on the status of your 
workstation log file. The display shows the number of workstation lines used since you 
logged on. 

Format 

DXSPLAYALOG 

There are no parameters associated with this command. The following is an example 
of the display produced by the DISPLAY LOG command: 

TOTAL WORKSTATION LINES 0000063 

If the command is not accepted, you receive the same message, WORKSTATION 
LOGGING NOT ACTIVE, as when the BRKPT LOG command is not accepted. 

The following condition could cause this command to be rejected: 

• Incorrect Syntax 

The command was misspelled, not entered correctly, or entered with parameters. 
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The commands contained in this section enable you to interactively perform utility 
routines. 

Utility routines perform the "housekeeping" chores that need to be done on every data 
processing system. These commands simplify the housekeeping chores by removing 
the need to create job control streams to run the utility routines. Utility routines 
perform such functions as erasing files to make more storage space available, 
allocating files for fiiture use, making printed and punch card copies of files, and 
obtaining information about the status of files and Hstings of the files currently stored 
in the system. 

The utility routines described in this section are not the only such routines available 
to you. Also available fi-om the workstation are the data utilities, which enable you to 
work with the contents of data files on the system. See 5.3 for more information on 
the data utilities. 

4. 1 . File Parameters 

If you want to use a command that acts upon a file (allocating, copying, erasing), you 
must define the file to be acted upon. You do this by entering a set of file parameters 
with the command. The file parameters are entered as keywords. The following is an 
example of a keyword parameter: 

VSM=volui« 

The keyword, VSN, defines the parameter to the system as the volume serial number 
of the file being referenced. The equal sign (=) tells the system that the next group of 
characters is the actual parameter. After the equal sign, you enter the actual volume 
serial number of the file being referenced. Thus, to enter this parameter for a volume 
with the volume serial number PAY346, you would key in VSN=PAY346, 

In many cases, the first two or three letters of a keyword are underlined. This means 
that you need to enter only the underlined letters, not the entire keyword. If the 
ke5rword is not underlined, you must enter the entire keyword. You can always enter 
any whole ke3rword, and the system accepts it. Each ke5rword parameter must be 
separated fi-om the one preceding it by a comma. The first keyword parameter must 
be separated from the command by a single space. 
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Many command formats include not only file parameters but other parameters, 
appearing after tiie kejnvord parameters, at the end of the parameter string. These 
other parameters are termed command options^ and serve to modify tiie aetivity of the 
command witii wMch they are associated. They must be separated from tiie keyword 
parameters by a single spacer and from each otiier by a comma. They are defined with 
the commands tiiey modify. 

The keyword parameters are defined in the following section. They are listed 
alphabetically. Refer to the format of each command to find out which keyword 
parameters are needed for that particular command. 

Note: You can enter some of the parameters in a positional format. For more 
information on using the positional format, refer to Appendix D. 



4.2. Keyword Parameters 



ACCT-acet 

Specifies the account number of the job that created the spool file you want 
to access. The account number can be from one to four alphmimneric 
characters long. 

ALL- r ill ■_ 

Specifies whether or not all spool files mth the specified parameters are 
processed. If you specify YES, all the spool subfiles with the specified 
parameters are processed. If you specify NO^ only tiie first spool file f oimd 
with &e specified parameters is processed. 



For disk files: 

Specifies the minimum I/O buffer size for the MIRAM file you want to 
access. Spedfjdng a larger-than-minimum buffer size could reduce the 
number of disk I/O calls and nm your command faster. Not specifying a 
buffer size causes tius parameter to default to a buffer size appropriate for 
the file you are accessing. 

For tape files: 

Specifies the block size witiiin a tape file. 

BKMO= r YES 1 

When you specify this parameter for a tape output file, it creates block 
numbers on the tape as the file is being created. When you specify this 
parameter for a tape input file, the block numbers of the file are checked. 
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coMTiG= r SB 1 

Specifies whether the file to be created should be allocated contiguous or 
noncontiguous space. YES causes the file to be allocated contiguous space; 
NO causes the file to be allocated noncontiguous space. File space on data- 
set-label (DSL) diskettes must be contiguous; therefore, take the default 
YES when allocating space on DSL diskettes. This parameter is specific 
only when creating a new file. 

COPIES- f n 1 

— m 

Specifies tiie number of copies you want made of a spool file. This parameter 
applies only to spool files created by commands such as the PRINT 
command. This parameter takes effect when the spool file is processed by an 
output writer and sent to the peripheral device for output. For example, 
specifying C0PIES=2 causes two copies of the file to be made. 

You can make up to 255 copies of a file. 

DEVICE= did 

DISKETTE 



PRIMT 

pyncH 

RDR 

- W^ 

Specifies the type of device you want to use to read from, or write to, as a 
sequential file, did specifies the device address of the device you want to use. 
The first digit is the channel number; the second and third, the hardware 
address. The other choices, DISKETTE...TAPE, specify the type of device to 
be used, but not a specific device. If you do not specify a device, the 
parameter defaults to disk. If you are using a disk or diskette and specify its 
volume serial number, you do not need to enter the DEVICE= parameter. If 
the volume you want to use is mounted, the system will find it. 



EXTEIIO= 



Specifies whether the contents of a file are either overwritten or merged with 
new data. If you take the default YES, the existing file remains intact and 
the new data is added to the end. If you specify NO, the data is overwritten, 
but the file characteristics are preserved. To overwrite a file using new file 
characteristics, use the INIT=YES parameter instead of EXTEND. (The 
default values for EXTEND and INIT specify the same condition. The two 
parameters differ in how a file is overwritten with new data.) The EXTEND 
parameter is ignored if you specify INIT=YES. EXTEND applies only to 
MIRAM data files and tape files. 
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FILENAME^ 



filename 
•filename' 



"f i lename" 

Specifies the name of the file referenced. In all cases except two, the file 
name must be that of an existing file. The exceptions are file names entered 
with the ALLOCATE command and file names entered for files you. are 
creating through the COPY command. In both cases, the names entered 
must be names you create. Physical file names can be fi-om 1 to 44 
alphanumeric characters long. Logical file names (for spool files) can be from 
1 to 1 7 characters long. Tape file names can also be from 1 to 1 7 characters 
long. The file name must he enclosed in either quotation marks or apostrophes 
if there are spaces, commas, or parentheses embedded within the file name. 



HOLD= 



!NC= 



Specifies whether or not a spooled file has been placed in a HOLD state. 
Files are held in two ways. The first is through the use of a HOLD command, 
from the workstation or system console, or the inclusion of a HOLD job 
control parameter. The second is by specifying the file to be retained after 
processing. A file placed in a HOLD state by the first method has not been 
processed. A file placed in a HOLD state by the second method has been 
processed once. If the file you are referencing is a log file, and is in a HOLD 
state, enter L. If the file you are referencing is a t3^e other than a log file 
and is in a HOLD state, enter Y. If the file you are referencing, log or other 
type, is not in a HOLD state, enter N. If you are accessing a file on the reader 
queue (RDR), the HOLD option is forced to NO. If you omit the HOLD option 
for any other type of spool file, all HOLD options will be tried in order: 
HOLD==NO, HOLD=YES, HOLD=LOG. Then, any file meeting the specified 
file characteristics, including the HOLD option, is located. Retained input 
files are not placed on HOLD. 



Specil 



specifies the number of cylinders of disk storage space added to a file when 
it fills its original allocation of space and requires further space. This 
parameter does not apply to files on data-set-label diskettes. DSL diskettes 
cannot be extended. 



44 
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mF= I ^Es 




Ties whetiier the contents of a file are to be ©verwritten with new data 
being added. If you. specify NO (tiie def ault), the old information remains 
inteet and the new data is added to the end of the file. If you specify YES^ 
&e original file contents are overwritten with the new date, but tiie original 
file characteristics are not preserved. (The only exception would be if tiie 
original file was created by using the default values for all the file 
parameters.) INIT assumes the default values for all file parameters. To 
overwrite a file using the old file characteristics^ use EJff ENDsNO, not 
INIT. Otherwise, use INIT and specify your new file parameters. MIT 
applies only to MIRAM data files and tape files. 



JOB-j©taai» 

Specifies the name of the job that produced the spool file you want to access. 
The job name can be from 1 to 8 alphanumeric characters long. 



KEY!: 



(mill,f DUP _ 1 ,r CHG^^ |) 

Specifies the starting and ending column positions of a key (i=l»5). You can 
repeat ttiis parameter for as many of tiie five keys you have available to you 
when creating a file. If you use this parameter with an existing file, your 
specifications must match tiiose of the present file. DUPMDUP specifies 
whether ©r not duplicate keys are allowed. CHQWCHG specifies whetiier or 
not keys can be changed. 



Specifies the number of the key used to access a MlKAM file, n can be from 
lto5. 

HODULE^^nwduienane 

Specifies the name of tiie module being referenced. It can be from 1 to 8 
alphanumeric characters long. 



QUEUE- I LOG 

PUNCH 

RDR 

Specifies the spool file directory of the spool file you are referencing. This 
parameter is valid only when referencing a spool file. You can enter LOG, 
PRINT, PUNCH, or RDR. LOG indicates that the file is in the log spool 
directory. PRINT indicates that the file is in the printer spool directory. 
PUNCH indicates that the file is in the card punch spool directory. RDR 
indicates that the file is in the card reader spool directoiy. 
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RCB- 




es whether or not a MIRAM file is created with a record control byte. 



RCFM= 



FIX 
VAR 
FIXUMB 

FIXBLK 
VARU^B 
VARBLK 
UMDEF 

Specifies the record format of a file. For a MIRAM file or a unit record file, 
you can specify either FIX or VAR. For a tape file, you. can specify any of the 
others. This parameter applies only to tape, unit record, and MIRAM files. If 
you enter this parameter for an existing file, it must match the present 
record format of the file. For more information on record formats, refer to the 
Consolidated Data Management Programming Guide (UP-9978). 



RCSZ=n 



Specifies the record size of the file or module being accessed. The default 
value of this parameter is based on the type of file or module you want to 
access. The following table gives the default values: 



Parameter 
Library modules 
MIRAM files 
Tape files 
Card files 
Printer files 
Diskette files 



Default Valoe 

128 bytes 

256 bytes Cor record size of existing file) 

256 bytes Cor record size of existing file) 

80 bytes 

132 bytes 

Same as MIRAM files if recorded in format-labef 
mode; 128 bytes if recorded in data-set-label mode. 



RDPASS=password 

Specifies a password used to control read access to the file being referenced. 
A password is required if the file is listed with a read password in the catalog 
file. If the file referenced is to be cataloged, you must specify passwords if 
you want the file to be accessible only through the passwords. Passwords can 
be from 1 to 6 alphanumeric characters long. You can specify that a file have 
both read and write passwords, or only one or the other, or no passwords at 
all. 
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specifies whe&er the file being created should be a SAT (system access 
technique) or a MIEAM Hbraiy file. If you are creating a librae file, you 
must specify YES if you want the system to allocate a SAT file. Otherwise, 
the system will allocate a MIRAM libraiy file. You should specify a SAT file 
when the program to be placed in tiie file is to be compiled, linked, or in 
some way accessed by the system. 

-" { m } 

Specifies the sector size of the MIBAM file. This parameter is specified only 
when accessing a file on a volume mounted on a nonsectoiized selector 
channel device. The following are nonsectorized selector channel devices: 

• 8430 disk drive 

• 8433 disk drive 

Note: This keyword parameter defines the sector size of the disk pa^k when 
creating a file; it must match the file for an existing file. 

suEm 

Specifies the size of a new file to be allocated. The value ofn specifies the 
number of flinders for disk files and number of blocks for diskette files. 
This parameter is specified only when creating a new file. 



aiP= 



Specific 



Specifies the number of spools that are to be skipped before accessing a spool 
file for processing. The default value of indicates that the first file found 
matching the specified parameters is accessed. 

•a f i»<ijle-t>^ 1 

is I 

specifies flie type of module being referenced. For SAT files, ttie types 
permitted are source (enter S), macro (enter M), procedure (enter P), proc 
name (enter PN), load (enter L), or object (enter 0). 

Note: A specification ofh includes both blocked and unblocked load 
modules. 
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For MIRAM files, you can specify format (enter F), saved job control stream 
(enter J), screen format (enter FC), menu, (enter MENU), help screen (enter 
HELP), or any other type available on your system. You. can create your own 
MIRAM module types, identifying them with, a 1- to 4-character type. The 
MIRAM module types can serve as qualifiers for tiie modules they are 
associated with. 

¥SMsvoliJ!» 

Specifies the volume serial number of the volume on which the file you are 
referencing is located. The volume serial number is required if the file is not 
cataloged. The volume serial number can be from one to six alphanumeric 
characters long. The VSN for SYSRES is RES. 

Note: You can reference system files (those with file names of$Y$^^ 

without specifying a volume serial number. The system assumes the 
files are on the SYSRES disk volume. 

WPASS=passMord 

specifies a password needed to control write access to the file being 
referenced. A password is required if the file is listed with a password in the 
catalog file. If the file referenced is to be cataloged, you must specify 
passwords if you want the file to be accessible only through the passwords. 
Passwords can be from one to six alphanumeric characters long. You can 
specify tiiat a file have both read and write passwords, or only one or the 
other, or no passwords at all, 

4.3. Allocaing Files {ALLOCATE Command] 

The ALLOCATE command enables you to allocate files interactively witiiout using job 
control statements. 'The ALLOCATE command reserves space for a file on a disk or 
diskette of your choosing, and identifies the reserved space for use by the file you 
create. The parameters entered with the command permit the system to reserve 
enough space for your file and to provide for increasing the space reserved. This 
increase is performed if you want to add more data to the file after the original 
allocation of space is used up. You can allocate different tjrpes of files, depending on 
the hardware you use. You cannot allocate spooled files or tape files with this 
command. You can allocate only disk or diskette files. 

The two types of files you can allocate are MIRAM and SAT files. Data files, menu, 
HELP, saved, and screen format modules are allocated as MIRAM files, and program 
library files are allocated as SAT files. If you are using diskettes, they can be recorded 
in either DSL or format label (FL) mode. For DSL diskettes, enter MI as the file type; 
give the SIZE= parameter in number of blocks. (You cannot specify a block size. It is 
assumed to be 256 bytes. Therefore, if your DSL diskette is formatted in 128-byte 
blocks, you will get two 128-byte blocks for every block you allocate.) DSL diskette files 
cannot be ^tended; therefore, any INC= specification is ignored. FL diskettes are 
accessed in the same way as disks. Therefore, they can be allocated as either MIRAM 
(MI) or SAT (ST) files. The INC= and SIZE= parameters are given in flinders. 
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Note,' To allocate DSL diskettes as basic data exchange (BDE), or to allocate a file 
with an expiration date, use the 1 1 EXT job control statement, not the 
ALLOCATE command. 

The ALLOCATE command issues a message to you, informing you when it has 
completed processing. You can use more than one line of the workstation screen to 
enter this command and its associated parameters. To do this, place a dash (-) as the 
last character in the first line of the command. The system recognizes the dash as a 
continuation character and asks you (in a message) for fiirther input. You can use as 
many lines of the screen as you want; just place a dash at the end of every line except 
the line on which the parameter string ends. 



Format 



ALLOCATEA 



{"U'" 



LENAME^ 



,VSN=v©U 



fil 



,CONTIG- 



l , RDPASS=passMord] I , WRPASS-password] 



{f } ■""'{!] 



,SiZE=n 



Command Option 



{"U 



Specifies the iype of file you want to allocate. Enter ST for SAT libraiy files 
and MI for MIRAM data files. 

Example 

AL HI,FILENAHE=HIRAMFILE,VSN=PACK01,INC=5,SIZE=10 

In this example, a MIRAM file named MIRAMFILE is allocated- The file is allocated 
on the volume that has a volume serial number of PACKOl. Initially, 10 cylinders of 
disk space are allocated to the file; as more space is required, it is allocated in 
increments of 5 cylinders. 

The following conditions could cause this command to be rejected: 

® Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 

® File Already Allocated 

A file with the same name as the file you are attempting to allocate has already 
been allocated. 
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® No Room for File 

There is not enough space left on the volume you specified for the size file you 
want to allocate. 

• Invalid Password 

The password you entered is not valid. 

4 A. Adding and Modifying Library Module Comments 
fCOMMENT Command] 

The COMMENT command enables you to add a comment to a library module header 
or to replace an existing comment. You must allow a single space between the last file 
parameter and the beginning of your comment text. Anything following that space is 
considered part of the comment by the system. Comments can be up to 30 characters 
long. Longer comment texts are truncated to 30 characters. The COMMENT command 
issues a message to you, informing you when it has completed processing. 

To find out if any comments have been added to a module, use the FSTATUS 
command with the LONG parameter (4.12) or use the COP librarian statement (see 
the System Service Programs (SSP) Operating Guide (UP-8841)). 

You can use more than one line of the workstation screen to enter this command and 
its associated parameters. To do this, place a dash (-) as the last character in the first 
line of the command. The system reco^izes the dash as a continuation character and 
asks you (in a message) for further input. You can use as many lines of the screen as 
you want; just place a dash at the end of eveiy line except the line on which the 
parameter string ends. 



Format 



CWIMEMTi&MODULE^rooAj i 



.TYPE- r nwdjie-tyrc 1 

- ii I 



.FILE^AME- 



ffl 



[ fRDPASS-password] [ , WRPASS=password] ,VSM=volt.meAtext 

Command Option 

text 



Specifies the text of the comment you want to insert, or the text you want to 
insert in place of the existing comment. It can be up to 30 characters long. A 
single space must separate the text from the file parameters. 
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Example 

CWi M0DULE=PART1ME,FILENAME^PAYFIL PART TIME WORKERS 

In this example, the comment PART TIME WORKERS is being added to the module 
named PARTIME, located in the file named PAYFIL. Since no module type is 
specifiedj the module is a source module. No password is needed to access this file. 
Since no volume serial number is included among the file parameters, it is assumed to 
be included in the file catalog entry for the file containing the module to which the 
comment was added. 

The following conditions could cause this command to be rejected: 

® Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
entered improperly. 

® File, Module, or Volume Not Available 

The file, module, or volume you requested is not available for your access. 
® ■ Invalid Password 

The password you entered is not valid. 

43. Copying Files (COPY Command] 

The COPY command copies modules or files. You can also use it to alter the format of 
a file. You can copy one type of file to another type. For example, you can make a 
spooled file copy of a MIRAM file or a tape file copy of a spooled file. You can use the 
COPY command with these types of files: MIRAM, library module, spool, tape, and 
unit record files. The different parameters required for each type of file are shown in 
five formats explained later in this subsection. 

Interactive services sets the date/time stamp on source and procedure modules to the 
current date and time. It retains the original date and time on load and object 
modules. To retain the original date and time on source and procedure modules, you 
must use the librarian to copy the modules. For more information about the librarian, 
refer to the System Service Programs (SSP) Operating Guide (UP-8841). 

To copy one type of file to another type using the COPY command, use the appropriate 
input and output parameter strings. For example, to copy a MIRAM file to a spool 
file, use the input parameter string in Format 2 (for MIRAM files) and the output 
parameter string in Format 3 (for spool files). (The input parameter string is 
ever3rthing preceding the word TO; the output parameter string is everything 
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following it.) You must place the delimiter TO between the input and output 
parameter strings. The word TO must be separated from the input and output 
parameter strings by single spaces. The command is rejected if the spaces are 
omitted. 

The COPY command runs as a background task. You can enter other commands 
while the COPY command is executing. You will receive a message when the COPY 
command is finished. 

You can use more than one line of the workstation screen to enter this command and 
its associated parameters. To do this, place a dash (-) as the last character in the first 
line of the command. The system recognizes the dash as a continuation character and 
asks you (in a message) for further input. You can use as many lines of the screen as 
you want; just place a dash at the end of every line except the line on which the 
parameter string ends. 



Format 1 (Copying SAT or MIRAM Library Modules) 



COPYAHODULE=modu I ename 



,TypE= 



r module- 

is 



type 



,FILENAME= [ filename 

'f f iename' 
"filename" 



C,RDPASS=password],VSN=volumeAT0AM0DULE=modulename3 



.FILENAME= j filename 
I 'filename' 
"filename" 



,TYPE= r module- type 1 

~ P 1 

[.RCSZ=n][,WRPASS=password3,VSN=volti!ie 



,CONTIG= J YES 1 ,IMC= J n ' 

I NO I |:ij 



[,SI_ZE=n] 



,SAT= r YES 1 



A[MUMBER][,HEX][,WAIT] 



Note.' There are two modules for every screen format: an F type module and an FC 
type module. To copy a screen format, you must copy both modules in two 
separate COPY operations. Remember to specify the file type by using the 
TYPE= parameter. The rest of the file parameters remain the same for both 
modules. 

Command Options 

MUMBER 

Specifies that each record is prefaced with a record number in the copy made 
of the file. 

Note: This option makes each record 10 characters longer. 
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Specifies that tiie copy made of tiie file has its records translated into their 
printable hexadecimal equivaleiit. 

Note! This option doubles the size of each record. 

Specifies that control is not returned to workstation mode until the COPY 
command has completed execution. Normally, when you issue a COPY 
command, a background task ie created^ and tiie COPY command executes 
as a ba&groimd job, allowing you to continue to use workstation mode for 
user or system pro-ams. However^ &ere can be times when you want to be 
sure tiie copy operation has been completed successfully before going on 
with your pro^i'amj sudi as when you are making a ba Aup copy of a file. In 
Ms caBCj entering tiie WAIT ke3?word with the COPY command stops the 
workstation mode until the command completes execution. 

Format 2 (Copying MIEAM Data Files) 



COPYAFILEMM^E^ 



file 



I ^ RDPASS=passMord] , VSN^oli, 



fSUMO^ 



{S} 



»5iviCE= 



did 



ATOAFILENAME= 



file 
•fii 



[ , WASS=passiiord] , VSM=vo i «ne 



.^T.==|iiSj ...C^lnl .K|WO=|nJ 



t,SiZE=n] 



.■mT=||s| .s<™o=|B| 



,RCB== f YES 1 ,RCFM=^ f 11 1 



I,RCSZ^] 



,KEYi= 



imm, r W^^ 1 , f CHG^^ 1 h 



i§^^- 



[m] 



.MXICE- 



did 



C,BFSZ==n3A[MUMBERH. HEX] [, WAIT] 
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Conmund Options 

Command options are &e same as m Format 1. 
Fofmat S (Copying Spwl Ffles) 



»TAEJ0B=jotaa»3 



£,ACCT-acct3,aJEUE^ 



.HOLDS 


■ L ] 


• 


N ' 




Y J 


EUE^ 


■ im ] 




PRINT 




PUMCH 




L RDR J 



ATOACJOB=iobiai«] 



.m-0^ 



,ALL= r ^S I 
,FILEMAME= 



file 
•fli 



,QUEUE= 



PRIMT 

mum 

R0R 



AWUMBERJC,HEX3C,WAIT] 



,«P= 



file 
^ffi 
'^fli 



{S} 



Comnaand Options 

Command options are tiie same as in Format 1, 
Fonnat 4 (Copying Tape Ffles) 



COPYA 



HLEUmE^ 



fit 
"fil 



£ ,R0PASS=pa8sw©rd3 .VSMsvoluiw.OEVICEi 



{'^] 



.iKMO= 



ATOA 



FILEMAME- 



file 
'fli 
"f!i 



E,WPASS^a88WOPd],VSM^oli«K,DEVICE= J did | 

1Iape| 



.im-- 



,BKNO» 



[W] '^"""l- } 



{W} 



.5S£M^ 



FIXBLK 
VARUMB 
VARBLK 
UNDEF 



C.I£SZ^3 



C,RraZ^MCiUMBER3C,HEX3[,WAIT] 
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Command Options 

Command options are the same as in Format 1. 
Format 5 (Copymg Unit Eecord Files) 



PTADEVICE- 


■ did 


■ 


DISKETTE 




. RDR 


ATOADEVICE= 


■ did 
DISKETTE 




PRIMT 




. pmm 


,FILEHAME= 


fi"lenai» 




^fllenane' 




1 


•filename" 



,FiLEMAME= 



.m.^= 



fill 
•fil« 

"filenaite" 



,VSM=¥0il 



.RGSZ-n] 



,¥SN-volui»eACHUMBER3[,HEX]C,yAIT] 



Note: The FILENAME- and VSN= parameters are required only when using a 
diskette. 

Coimmand Options 

Command options are tiie same as in Format 1. 

Example 

COP MODULE-SYSDUMP,FILEIIAME=$Y$JCS TO FILENAME- J CL,QUEyE=RDR,HOLD-^ 

In this example, tiie module named SYSDUMP, located in tiie file named $Y$JCS, is 
to be copied to a spool file name JGL, located on the RDR (reader) spool queue. The 
file is not specified to be retained after processing. 

The following conditions could cause this command to be rejected: 

® Incorrect Sjmtax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 

® File, Module, or Volume Not Available 

The file, module, or volimie you want to copy is unavailable for your use. 
® Invalid Password 

The password or passwords you entered are not valid. 
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4s6. Assigning Commands to Function Keys {DEFKEY Command) 

The DEFIffiY command enables you to assign any interactive command to a function 
key or to the MESSAGE WAITING key. (See Appendix A for the location of the 22 
function keys and the MESSAGE WAITING key on your keyboard.) Once youVe 
assigned a key, you simply have to press it to execute the command associated with it. 
Your workstation can be in data or system mode when the function key is pressed. 

You can include function key assignments in your execution profile. However, when 
you assign a function key, it is valid only during your workstation session and only for 
your user-id. Another user with a different ID does not get the same results by 
pressing the function key youVe assigned a command to. To assign function keys for 
other users, you can include the function key assignments in their execution profiles. 

To free a function key from a command string, see the DEFKEY DELETE command 
(4.7). To assign a new command string to an already assigned function key, enter the 
DEFKEY command with the new command string. This overrides the previous 
assignment for that key. 

Notes: 

1. You must take care not to redefine keys used by interactive services or any of the 
interactive facilities. If you do reassign them, you will lose the functions they 
provide. These function keys are listed in Appendix E, 

For screen format services users: Be aware that screen format services (SFS) also 
allows you to assign function keys that are used by a program. If you assign a 
function key already used by your SFS program, the DEFKEY assignment takes 
precedence and you lose the SFS function key capability. 

2. The DEFKEY command can be used at the system console. To use a function 
provided by a function key from a console that has no function keys, enter F#n or 
#n where n is the function key number. You can also invoke the function key from 
a workstation in system mode by entering F#n, #n, or MSGW. 

Format 

DEFKEYA 



J F#nn \ , J 'cotrmand string' \ 
I HW J I "cotmiand string" j 

where: 



Is the 1- or 2-digit number of the function key you're assigning a command 
to. 
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MW 

Stands for the MESSAGE WAITING key. 

'cormnand string' 

"cofrmand string" 

Is the actual interactive command string. It must be enclosed in either 
single or double quotes and can be up to 60 characters long. 

Note! The DEFKEY command does not check the syntax of your command string. If 
you make an error in the command string, it won't show up until you actually 
use the function key associated with it. At that time, you will get an error 
message that an illegal command has been entered. 

Examples 

DEFKEY F#2/BR LO' 

In this example, the breakpoint log command is assigned to function key 2. When you 
press this key, the workstation log is closed and is made available to the output writer 
for printing, 

DEFKEY MW /'LOGOFF" 

In this example, the LOGOFF command is assigned to the MESSAGE WAITING key. 
When you press this key, the LOGOFF command automatically executes. 

The following condition could cause this command to be rejected: 

® Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
entered improperly. 

4.7. Deleting Fuoction Key Assignments 
(DEFKEY DELETE Command) 

To free a function key or the MESSAGE WAITING key from a command assignment, 
you use the delete form of the DEFKEY command. The DEFKEY DELETE command 
is exactly like the DEFKEY command, minus the command string. Once you delete a 
command assignment from a function key you can reassign a new command to it. (To 
view a list of the function keys assigned under your user-id, use the DEFKEY 
DISPLAY command, 4.8.) 
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The format of the DEFKEY DELETE command is: 

DEFKEYA 



{T} 

where: 



Is the number of the fimction key (from 1 to 22) that you previously assigned 
a command to. 

MW 

Is the MESSAGE WAITING key. 
Examples 

DEFKEY F#5 

In this example, ftmction key 5 is no longer associated witii the command string 
previously assigned to it. 

DEFKEY MW 

In this example, the MESSAGE WAITING key is freed from the command previously 
assigned to it. 

The following condition could cause this command to be rejected: 

• Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
entered incorrectly. 

4«8. Displaying Function Key Assignments 
IDEFKEY DISPLAY Command) 

The DEFKEY DISPLAY command displays all the function keys and commands 
assigned under your user-id during a workstation session. (See the DEFKEY 
command, 4.6.) If function key assignments were made a part of your execution 
profile, this is a very useful means of finding out what commands the fimction keys 
will execute. 
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Format 

DEFKEYADISPUY 

The format of the function key display that appears on your workstation screen is: 

F#rm-c«niand string 
where: 



nn 

Is the function key number (from 1 to 22). 



string 
Is the actual interacti¥e command assigned to that key. 



A sample function key display is shown below: 

DEFKEY DISPLAY 

11 OEFKE0i4 F#06=BR LO 

12 DEFICEi®4 F#07»EDT 

13 DEFKE884 F#a8s:L0eQFF 

14 DEFKE004 F#09=STATUS 

The following condition could cause this command to be rejected: 

® Incorrect Syntax 

The command was misspeled ©r ambiguous, or the command or parameters were 
entered improperly, 

4.9. Using the interactiwe Commands in a Batch Enwironment 
(ENTER Command) 

The ENTER command enables you to run an interactive workstation session as a 
batch task. You can build a sequence of workstotion commands, from LOGON to 
LOGOFF, and store it as a library module on the spool file, or on a diskette, a tape, or 
a deck ©f punched cards. You can then ran the stream of workstation commands as a 
batch job. 

You cannot use the CONNECT, SCREEN, FREE, BRKPT, DELETE, DISPLAY and 
FILE workstation commands because jobs performed using the ENTER command do 
not direct any oulput to a workstation. All output is directed to a printer. 
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Unlike a job control stream, commands in a stream of workstation commands are 
processed one at a time, sequentially. If an error is discovered in a command, 
processing continues with the next command. If your ENTER stream includes a job 
control stream for entering a spooled input file, be sure the FILEID field of the 
//DATA card is the same as the FILENAME= parameter of the ENTER command 
used to run the ENTER stream. 

You can use more than one Hne of the workstation screen to enter this command and 
its associated parameters. To do this, place a dash (-) as the last character in the first 
line of the command. The system recognizes the dash as a continuation character and 
asks you (in a message) for further input. You can use as many lines of the screen as 
you want; just place a dash at the end of every line except the line on which the 
parameter string ends. 

The ENTER stream runs under the user-id of the workstation from which it was 
issued. If the ENTER stream is issued from the system console, it runs under the 
user-id specified in the LOGON command in the ENTER stream. 

Note: If you use the SC command (running already expanded job control streams) 

in a stream of workstation commands, you must enter SCH instead ofSC. SC 
is not accepted by the ENTER command to avoid confusion between the SC 
and SCREEN commands. 

Format 

To Run a Command Stream from a Libraiy File: 



EMTERAMODULE=modulename 



,TYPE= r module- type ] 



,FILEMAME= 



fil 
'ft I 
"fil 



[ ,RDPASS-password] ,VSM=v©liine 
To Run a Command Stream from a Spooled File: 



EMTERA 



HOLD= I M I 



.FILE?JAME= 



filename 

'filename' 
"filename" 



,QUEUE=RDR 



420 
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To Run a Command Stream from a DSL Diskette: 



EMTERA 




[ jRDPASS=password] ,VSN=voliii»e 



,DEVICE= f did 



= J did I 

1 DISKE TTE I 



To Run a Command Stream from a Tape: 



EMTERA 



FILENAMES 



ffl 
"fU 



[ .RDPASS-passHord] ,VS^-v©lLn» 



,DEVICE= f did I 
IIAPE J 



To Run a Command Stream from a Card Reader: 



EUTERADEVICE 



,DEVICE= J did 1 
I RDR I 



Example 

ENT MODULE- I N JOB , T YPE=S , F I LENAHE= JOBF I LE , RDPASS=SEEK , VSN=REL082 

In this example, a stream of workstation commands is read from a Kbrary module and 
executed. The module name is INJOB, and it is a source module. It is located in the 
library file named JOBFILE. To access JOBFILE, a password, SEEK, is entered. 
JOBFILE is located on a disk volume with the volume serial number REL082, The 
following is a typical stream of workstation commands. Note that it invokes the 
general editor and performs four editing commands. 

LOGOM J0B6,A263 
EDT 

aREAD MYFILE,DISIC02 
aCHANGE 'OPWM" TO 'OPEN' 
aWRITE 
. SHALT 

PRINT MYFILE,DISK02 NUMBER 
LOGOFF 
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The following conditions could cause this command to be rejected: 

® Incorrect S3mitax 

The command was misspelled or ambiguous^ or the command or parameters were 
improperly entered. 

® First Command Not LOGON 

The first command of any stream using the ENTER command must be the 
LOGON command. If you do not have a LOGON command as the first statement 
of your enter stream, the system rejects your ENTER command. 

• Data Cards Interpreted as System Commands 

This could happen if, for example, you have a LOGON card, an EDT card, and 
then a series of EDT commands. If the EDT card is not read for some reason, the 
system will attempt to interpret the EDT commands as system commands and 
reject each one it reads and misinterprets. 

• Cards in the Stream after the LOGOFF Command 

Cards in the stream after a LOGOFF command are not read. The system stops 
reading immediately upon reading the LOGOFF command. 

4 JO. Deleting Library Files and Modules and MIRAM 
Files (ERASE Command) 

The ERASE command enables you to delete Hbrary and data files, and library file 
modules. The ERASE command deletes library modules by marking them as deleted. 
The ERASE command deletes files by removing them from the volume table of 
contents (VTOC) for the volume on which they reside. When you enter the command 
to erase a whole file, the system displays the label of the file and the volume serial 
number where it resides, as follows: 

25?ERASE002 IS51 ERASIMG 'Ibl '.vsn , PROCEED? CY,M) 

Notes The message displays only the first 18 characters of the file label, which 
is 44 characters long. 

This helps prevent unintentional deletion of important files. You must enter Y before 
the system can go ahead and delete the file. The ERASE command issues a message 
to you when it has completed execution. 
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Since tlie ERASE command only deletes files or modules logically by removing them 
from the VTOC, they still physically exist. In the event you accidentally erase a 
source, procedure, or macro module in a SAT libraiy, use the RECOVER command 
(4.18) to recover the module. The RECOVER command is effective up to the time a 
LIBS PAC operation is performed. Once a LIBS PAC is completed, the file or module 
is permanently lost, logically and physically. MIRAM files cannot be recovered. 

You can use more than one line of the workstation screen to enter this command and 
its associated parameters. To do this, place a dash (-) as the last character in tiie first 
line of the command. The system recognizes the dash as a continuation character and 
asks you (in a message) for further input. You can use as many lines of the screen as 
you want; just place a dash at the end of every Hne except the line on which the 
parameter string ends. 

Format 

To Erase a Single Library Module: 



ERASEAMODULE=modulename 



,TYPE= r module- type ] 

~ is 1 



.FILENAME- 



fil 

•fil 

"fil 



[ ,WRPASS=password] ,VSN-volime 

To Erase Libraiy and MIRAM Files: 



ERASEAFILENAME= 




[ , WRPASS-password] , VSM=voli 



Note! To erase a spool file, you must use the DELETE SPL command, which is 
discussed in 3.3.9. 

Example 

ER HODULE=PAYMOD,FILENAME=$Y$JCS,VSN=RES 

In this example, the module named PAYMOD, which is part of the file $Y$JCS, is 
erased. The file $Y$JCS resides on the volume with the volume serial munber RES 
and is a source module. 

The following conditions could cause this command to be rejected: 

• Incorrect SjTitax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 
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® File or Module Not Found 

The system is unable to locate the file or module you requested. 
• Volume Not Available 

The volume containing the file you requested is not available. 
® Invalid Password 

The password you entered is invalid. 

4 J 1 . Discarding System Messages (FLUSH Command) 

The FLUSH command enables you to discard system messages queued for deliveiy at 
your workstation. You can discard all queued messages or only those with a specified 
message prefix. 

Format 

FLUSH r *ALL l 

I msg-prefix j 

where: 

*ALL 

Specifies that all queued messages are discarded 

msg-prefix 

Specifies that messages with this prefix are discarded 

4 J 2. Obtaioing File Status Information (FSTATUS Command) 

You use the FSTATUS command to obtain information about files and their contents. 
You can obtain information about the modules contained in a libraiy file. When you 
reference a library file using this command, you can select either a short or long 
display of module information. The short display gives a list of active modules and 
what type of module each is. The long display lists each module with its name, t3^e, 
comment (if one is present), and the date and time the module was created. If you do 
not want to see the entire output of your libraiy file, press function key 1 or 18. This 
terminates the output processing and displays an ED087 message. 

Note^ You can process only one FSTATUS command at a time. You cannot enter 

another FSTATUS until the command currently being processed is completed. 
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You can use more than one line of the workstation screen to enter this command and 
its associated parameters. To do this, place a dash (-) as the last character in the first 
line of the command. The system recognizes the dash as a continuation character and 
asks you (in a message) for fiirther input. You can use as many lines of the screen as 
you want; just place a dash at the end of eveiy line except the line on which tiie 
parameter string ends. 



FoiMiat 

For Library Files: 

FSTATUSA [MODULE=modu I enane ] 



.TYPE 



= f modjle-type ] 

is I 



,FILEMAME- 



fil 
"fil 



[ jRDPASS-password] ,VSM=^oliroeA[LOMG] 

Command Options 

Note^ With the FSTATUS command you can use the module name and module type 
as qualifiers to produce displays of groups of modules. 

To use the module name parameter as a qualifier, enter the characters you 
want to use to qualify the modules to be displayed, and enter a period (J as 
the last character of the module name parameter. The command then 
produces a display of all modules whose names begin with the characters you 
specified. For example, entering ABC. displays all modules whose names 
begin with the letters ABC. Entering the letters ABC without a period, 
however, displays only those modules named ABC. 

To use the module type parameter as a qualifier, enter the character or 
characters you want to use to qualify the modules to be displayed, and enter a 
period (.) as the last character of the module type parameter. The command 
produces a display of all modules whose type begins with the character or 
characters you specified. For example, if you enter F. as the module type, you 
get a display of all modules of type F, or whose type begins with an F. 
Entering only F with no period displays only type F modules. 



LOMG 



Specifies that you want to see the long version of the FSTATUS display for 
library files. If you do not enter LONG, the short version will be displayed 
by default. 
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Example 



If you want a short display of the modules contained in the libraiy file $Y$JCS, 
residing on volume REL082s enter: 

FS FILEMAHE=$Y$JCS,VSN-REL082 

You then see the following display: 



FSTATUS 


$Y$JCS,REL082 






P-J$CPYLBO 


P-J$COBOL 


P-J$FORT 


P-J$FOR 


P-JSLIMSC 


P-UTSLIU 


S-SYSDUHP 


S-COR#V 


P-CORRUM 


S-SU$PAT 







Entering the LONG parameter produces the following display: 



FSTATUS J, $YSJCS,PACK75 LONG 




P-J$CPYLBO EHUL AID 8410 DISC COPY 11/28/79 


09:27 


P-J$COBOL COBOL CAMMED JPRQC 11/28/79 


09s 28 


P-J$FORT FORTRAM CAUUED JPRQC 11/28/79 


09:28 



The following conditions eould cause this command to be rejected: 

® Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 

® File or Volume Not Available 

The file or volume you want to access is not available. 
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• Invalid Password 

The password you entered to read the file is not valid. You are denied access to 
the file. 

• Attempt to Reference a Spool File 

The FSTATUS command cannot be used to obtain information about a spool file. 
Only library files can be referenced. 

4.13. Obtaining Command aod Message Assistance 
IHELP Command) 

You use the HELP command to obtain information on how to use other workstation 
commands and how to handle error messages sent to you by the system. When you 
enter HELP for a commands you receive a screen display explaining the command and 
its use. When you enter HELP for a message, you receive a screen display explaining 
the message and how to respond to it. 

Format 

HELPA r conmand 1 
I message -no [ 
[ keyword-parameter J 

Parameters 

conmand 

Specifies the command you need help with. You must enter the command in 
its entirety; you cannot abbreviate it. 

message-no 

Specifies the message you need help with. You identify the message using 
the 4-character id that is part of the message text. For example, all 
interactive services messages are preceded with an 8-character id. This id 
consists of up to a 5-character prefix plus the 3-character id. When the 
command is less than 5 characters in length, it is padded with blanks. 
Consider the various parts of this sample message: 

message text 

I ' 1 



XXXXXXXX IS78 EXECUTE COMMAND STILL ACTIVE, WAIT FOR IT TO FINISH 

'-r-'V 

message message number 

prefix (use with HELP conmand) 



All message numbers appear in the message manual. 
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Note: System error codes contain only numbers. To get help for a system 
error code, enter HELP ECerror-eode, where eiror-code must be 3 
digits long, with a leading zero if necessary. Thus, to get help for 
error code 51, you enter HELP EC06L 

keyword • parai»ter 

Spedf ies a keyword parameter used in a commaBd. If you need help witli a 
kejrsvord parameter, you must enter the keyword, for example, HELP 
FILENAME, HELP MODULE, or HELP VSN. You must enter the 
parameter in its entirety; you cannot abbreviate it 



Note: 



You can receive help for many commands, messages, and keyword 
parameters; if, however, you enter a command, message, or keyword 
parameter for which help is not yet available, you receive the following 
message: 

IS94 THE HELP YW REQUESTED IS MOT AVAILABLE, SORRY. 

Examples 

Help for a message: 



HELP IS34 




32 


HELP@07 IS34 ILLEGAL 


CCMMAND HAS BEEH EMTERED, IGMORED 


33 


HELP807 A CWmm BAS BEEN ENTERED THAT THE SYSTEM DOES MOT | 


34 


HELP807 RECOGNIZE. 


THE COMMAUD ENTERED canot BE OHE OF THE OS/3 


35 


HELP007 INTERACTIVE 


COmAUm, OR IT can BE A VALID GMMAUD SPELLED 


36 HELP887 INCORRECTLY. 


THIS COIMAND ALSO APPEARS IF A BRKJ , DELETE, 


37 IIELP007 DISPLAY, FILE, IM, PD, SO, OR TU COWAMD IS ISSUED AS PART 


38 


HELP007 OF AM ENTER 


STREAM. 


39 


HELP@07 




40 


HELPii7 CHECK COWIAMD VALIDITY AMD SPELLIHGj CORRECT THE COMAMD AUD 


41 


IIELPii7 REEMTER. 




42 


HELP007 IS90 HELP 


■cmmin terminated hormally 



The top of the screen shows the HELP command entered for message IS34, The next 
10 lines of tiie screen are the HELP display, explaining the message and giving you a 
list of permitted commands. The final line of lie display shows that tiie HELP 
command has completed. Note tiiat &e command is entered in uppercase letters; as 
with all commands, you can enter it in either uppercase or lowercase. 
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Help for a command: 



•LP ALLOCATE 



43 HELP0i7 

44 HELP087 

45 HELP007 

46 HELP®07 

47 mipmr 

48 HELP@07 

49 HELF0@7 

50 HELP007 

51 MELP0a7 

52 HELP007 

53 HELP007 

54 HELFi07 

55 HELPi07 

56 HELP007 

57 HELP007 

58 HELP007 

59 HELP007 

60 HELP007 

61 HELP007 

62 HELF007 

63 HELP007 

64 HELP007 



YOJ USE THE ALLOCATE COMHAMD TO ALLOCATE FILES WITHOJT 
USIMG JOB COMTROL STATEHEMTS« IT INTERACTIVELY RESERVES 
SPACE FOR A FILE ON A DISK OR DISKETTE OF YOJ CHCWSIMG 
AHD IDEMTIFIES IT TO THE SYSTEM. THE CMMAND FORMAT ISs 

ALLOCATE <FILE-TYE>,FILEHAME=,VSM-,SIZE,C,RDPASSal 
[,yRPASS=][,COMTIG-][,IIIC-] 

FOR AM EXPLAMATION OF EACH KEYWORD PARAMETER SEE ITS HELP 
SCREEM. THE SINGLE CWMAMD OPTIOM AVAILABLE WITH ALLOCATE 
IS FILE -TYPE. VALID FILE TYPES VARY WITH THE HARDWARE 
YOJ'RE USIMG, AS FOLLWSs 



CCWMAUD OPTIOM 
ST 
HI 
IR 
IS 
DA 
SQ 
NI 



FILE TYPE 
SAT 
MIRAM 
I RAM 
ISAM 
DAM 

SEQUEMTIAL 
MONIHDEXED 



SERIES 90 
X 
X 
X 
X 
X 
X 
X 



SYSTEM 80 

,X 

X 



CX s CAM ALLOCATE THIS TYPE OF FILE WITH THIS HARDWARE ») 
1590 HELP COMMAND TERHIMTED NORMALLY 



The first line of the screen display shows the HELP command entered for the 
ALLOCATE command. The next 21 lines are the HELP display, explaining the 
function of the command^ its format, and the parameters entered with it. The final 
line of the display shows that the HELP command has completed. 
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Help for a keyword parameter: 



HELP SIZE 














81 


HELP086 


SIZE=<y> 












82 


HELP006 


SPECIFIES 


THE 


SIZE 


OF THE 


FILE TO BE ALLOCATED. 


THE VALUE 


83 


HELP806 


OF U SPECIFIES 


THE 


MUHBER 


OF CYLIMDERS FOR DISK 


FILES AMD 


84 


HELP006 


THE MUHBER 


OF 


BLOCKS FOR DISKETTE FILES. THIS PARAMETER IS 


85 


HELP0i6 


SPECIFIED 


ONLY 


WHEN CREATIMG A MEW FILE. 




86 


HELP006 


IS98 HELP 






COMMAND TERMINATED NORHALLY 





The top of the screen shows the help command entered for the size parameter. The 
next 5 lines are the HELP display, explaining the keyword parameter and showing its 
formal The final line of the display shows that the HELP command has completed. 

The following conditions could cause this command to be rejected: 

• Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 

® Invalid Parameters 

You entered the command with no parameters, or with something other than a 
command or message prefix. You can only enter either a message prefix or a 
command with the HELP command. 

4.13A. Creating an Alternate Workstation Logo |LGEN Commandl 

You use the logo generator (LGEN) command to create an alternate workstation logo. 
This lets you have your own customized logo displayed on the workstation screen 
before you log on, instead of the default OS/3 logo that is normally displayed (see 
Figure A-1). 

LGEN gives you the option of creating an alternate logo from a blank screen or from 
the default OS/3 logo screen. You can also modify or delete an alternate logo youVe 
already created. 

Format 

LGEM 

There are no parameters associated with this command. 
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To create an alternate logo, enter LGEN and press the XMIT key. The logo generator 
home screen is displayed: 



OS/3 Logo Generator 



Select Function (1): 


1 CREATE 




2 CREATE -FR« 




3 HOD I FY 




4 DELETE 




8 EXIT 


^Fimction keys are: F1 - 


Go to Home Screen 


F13 - 


Help 


F14 - 


Exit Help 



You. select a ftmction from the home screen by entering its item number witiiin the 
parentheses supplied on the screen, and then pressing the ^IIT key. The default 
¥alue is 1. You can also display help screens that explain the LGEN fimctions by 
pressing the F13 key. The fanctions are: 



CREATE 



CREATE-FROM 



MODIFY 



DELETE 



EXIT 



A blank screen is displayed. To create an alternate logo, enter 
the logo exactly as you want it to appear and ttien press the 
XMIT key. 

The OS/3 default logo is displayed. Change the logo to appear 
as you want and then press the XMIT key. This creates an 
alternate logo from the default logo. 

The alternate logo is displayed. Change the logo to appear as 
you want and then press the XMIT key. 

The alternate logo is displayed. Press the XMIT key to display 
the following message: Do you want to delete this alternate logo 
(Y/N) ? To delete the alternate logo, enter Y and press the 
XMIT key. Your system will then use the default OS/3 logo. 

Exits from the LGEN program. 
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Notes: 

1. If you select CREATE or CREATE-FROM when an alternate logo already exists, 
this warning message is displayed: LGOl (WARNING) ALTERNATE LOGO 
EXISTS, PRESS XMIT TO CONTINUE. You can continue and create a new logo, 
or change your selection. 

2. If you select MODIFY or DELETE when an alternate logo does not exist, this error 
message is displayed: LG02 NO ALTERNATE LOGO EXISTS. You must change 
your selection. 

3. If you execute LGENfrom the model 7E or model 50 console, it must be executed on 
the second screen. 

4. If your system has security installed, LGEN can be run only by the system 
administrator. 

4J4« Calling Menus {MENU Command} 

Menus are an OS/3 feature designed to simplify certain everyday operator tasks. 
A menu, is a list of items from which a workstation operator chooses. Usually these 
represent workstation commands, programs, or fimctions within programs. Menu 
items are numbered so that when the system displays a menu on your workstation, 
you select an item by entering its item number in the blanks provided on the menu 
screen and pressing the XMIT key. There are two types of menus: tiiose supplied by 
Unisys, called system menus, and those you create, called user-created menus. You 
create menus using menu services; Section 5 briefly outlines how menu services work. 
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Format 



muuh 



fUenane.vsn 



•{S} 



Parametere 



Is the name of a user-created menu you want to call. If you don't specify a 
menu name, menu services automatically call a standard system menu 
(included with your system) that is designed to acquaint new users with 
OS/3. For more information on system-supplied menus, see 1.4. 



fU 



Is the name of the MIBAM file where your menu resides. The default is the 
system format file, $Y$FMT. 



Is the volume serial number of the volume containing your menu file. The 
default value, the system-resident volume, RES, applies only if the filename 
parameter is $Y$FMT. For any other filename, you must specify this 
parameter even if it is RES. 



Examples 



MENU 



In this example, the MENU command with no menu name specified calls up the first 
of the menus supplied by Unisys. This menu resides in $Y$FMT on SYSRES. It looks 
like this: 







SYSTEM MENU 


OS301 






1. RUM A 


JOB 






3. END MENU 




2. PERFORM A 


SYSTEM FUNCTION 


4. LOGOFF 




FOR HELP ON 


A PARTICULAR ITEM 


MUHBER, 


ENTER A QUESTION 


MARK 


FOLLOWED BY 


THE 


ITEM NUMBER C?H). HELP 


FOR THE ENTIRE 


DISPLAY 


CAM BE ACQUIRED 


BY ENTERII^G A 


QUEST I CM 


MARK (?) THEN PRESSING | 


TRANSMIT. 
















ENTER 


SELECTION: 2 
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To select a function, enter the number associated with that function in the space 
provided, and transmit the screen. Menu services then display other menus giving 
you further choices of system facilities. As the menu screen describes, you can also get 
help with any part of the menu. 



MENU PAYROLL 



In this example, the MENU command calls up the PAYROLL menu from $Y$FMT on 
SYSRES, which lists various payroll functions: 



1. 


PAYROLL DATA ENTRY 


7. 


2. 


PAYROLL INQUIRY 


8. 


3. 


PAYROLL EDIT 


9. 


4. 


PAYROLL CHECKS 


10. 


5. 


PAYROLL ANALYSIS REPORTS 


11 = 


6. 


BACKUP PAYROLL FILES 


12. 



PAYROLL MEF 

RESTORE PAYROLL FILES 
EXIT FROM THIS MEMU 



ENTER SELECTION MUMBER: 



To select a function, enter the number associated with that function on line 8, and 
transmit the screen. If you need help with any function, enter a question mark (?) 
before the function number. Or, to get help with the entire screen, enter a question 
mark and transmit the screen. Menu services then display a help screen associated 
with that function or menu. 

The following condition could cause this command to be rejected: 

® Incorrect Syntax 

The command was misspelled or ambiguous, or the command or param.eters were 
improperly entered. 



4-32 



UP-9972 Rev. 2 



Utii% Commands 



4.15. Making Printed Copies of Files (PRINT Command} 

The PRINT command is used to make a printed copy of a SAT or MIRAM library 
module, a MIRAM data file, a spool file, tape file, or unit record file. You can direct 
tiie output of this command to either an actual printer or a spool printer. The printed 
copy produced by this command includes a header page containing identification 
information. 

The PRINT command executes as a background job, which enables you to continue to 
enter commands while it is executing. The PRINT command issues you a message 
when it has completed execution. 

You can UBe more than one line of the workstation screen to enter this command and 
its associated parameters by placing a dash (-) as the last character in ihe first line of 
the commMid. The system recognizes the dash as a continuation character and asks 
you (in a message) for further input. You can use as many lines of the screen as you 
want; just place a dash at the end of eveiy line except tiie line on which the parameter 
string ends. 

The PRINT command is divided into the following five formats: 

Format 1 (Printing SAT and MIEAM Library Modules) 



£R|.MTAMODULEswdul 



,V[PE= I rooAile-type'l 



.FILEMAMEs 



file 



- ill 



ACDIRECT]C,NUM8ER]C,HEX3C,WAIT3 



I ,RDFASS=pas8Mord] ,¥Sy=voiii!ie 
[,FORM=fonina!ie] 
Command Options 

DIRECT 

Specifies that an actual printer is assigned to print the file requested in the 
command. When DIRECT is not specified, the file requested is copied to a 
spool file and printed when a printer becomes available. When DIRECT is 
specified, the file is not spooled and is printed immediately if a printer is 
available. If DIRECT is specified and no printer is available, you will 
receive an error message at the workstation. The default condition is that 
the file be spooled. 

MUMBER 

Specifies tiiat line numbers are to be included witii the printout. 

HEX 

Specifies that the file be translated into its printable hexadecimal 
equivalent before being printed. 
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WAIT 

Specifies tiiat control is not returned to workstation mode until the PRINT 
command has completed execution/ Normallyj when you issue a PRINT 
command, a background task is created^ and tiie PRINT command executes 
as a back^ound job, allowing you to continue to use workstation mode for 
user or system programs. HoweYer, tiiere are times when you want to be 
sure the PRINT operation is completed successfully before going on witii 
your program. In this case, enter the WAIT keyword witii the PRINT 
command to stop the workstation mode until the command has completed 
execution. 

FORM-forrmane 

Specifies the form used for printing. When you specify this kej^word 
parameter, tiie output writer issues a message to load the correct form when 
it processes the spool file. When you specify the DIRECT parameter, tiiis 
parameter is ignored because spooling is bypassed. 

Format 2 (Printing MIKAM Data Fileg) 



PRIMTAFILEUAME^ 



ffl 

«ffl 



I , RDPASS-password] , VSNsvolume 



. fCEYM O= 



{i} 



- till 



.DEVICE- 



did 



A[DIRECT3[, NUMBER] [, HEX] [, WAIT] 



[,FORM=forntiane] 

Command Options 

Command options are the same as in Format 1. 
Format 8 (Printing- a Spool File) 



PRINTA[J0B=.iobname3 



,QUEUE= 



LOG 

PRINT 

PUMCH 

RDR 



.MOLD= 


■ L ■ 




■ 


U 






. Y . 




L 




J 



,FILEMAME= 



fll 
•fil 

"fll 



[,ACCT-aect] 



,ALL= f YES 1 .COPIES- f n ] ,SKIP- f n 1 

- JH 1 - ill I ~ fa 1 



A[DIRECT]t,HUMBER3 



t.HEX]E,yAIT]C,FORM=fornriane] 
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Command Options 

Command options are the same as in Format 1. 
Format 4 (Prmting a Tape File) 



PRINTA 



FILENAHE= 



filename 
• f U ename • 
"filename" 



[.RDPASS=password],VSN-volume. DEVICE 



= J did 1 
t W^ J 



,BKnO= f YES 1 



A[DIRECT][, NUMBER] C, HEX] [,WAIT]C,FORM=formname] 



Command Options 

Command options are the same as in Format 1. 

Format 5 (Printing a Unit Record File) 



PRINT DEVICE= j did 

I DISKE TTE 
RDR 



,FILENAME= j filename j ,VSN=volume 
I 'filename' I 
"filename" I 



ACDIRECT][, NUMBER] C, HEX] [, WAIT] [,FORM=formname] 

Note.' The FILENAME- and VSN- parameters are required only when using a 
diskette. 

Command Options 

Command options are the same as in Format 1. 

Examples 

PR I MODULE=PIB,FILEMAME=$Y$SRC NUMBER 

In this example, the source module PIB, located in the file named $Y$SRC, is printed. 
The NUMBER command option is included, so the printed output will have line 
numbers added to it. 

PR! FILENAME=L0NGMIRAMFILE,VSN=PACK23 

In this example, a file named LONGMIRAMFILE, located on volume PACK23, is 
printed. 
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The following conditions could cause this command to be rejected: 

• Incorrect S3mtax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 

■• File or Volume Not Available 

The file or volume you requested is not available for your use. 

• Spooling Not Configured 

The spooling process was not configured at the time your system was generated; 
therefore, no spool files exist to be accessed. 

® Printer Not Available 

If you entered the DIRECT option with this command and no actual printer was 
available to print the file you requested, the system will give you an error 
message and tell you to enter the command again. 

• Invalid Password 

The password you entered is invalid. 
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4J6. Waking Punched Card Copies of a File {PUNCH Command} 

The PUNCH command enables you to make punclied card copies ©f library moduleSs 
MIRAM data files, and spooled files. Output from the PUNCH command is directed 
to either an actual or spooled punch. You can continue to enter commands while the 
PUNCH command is being executed. The PUNCH command issues you a message 
when it has completed execution. 

You can use more than one line of tiie workstation sween to enter this command and 
its associated parameters by placing a dash (-) as the last character in the first line of 
ttie command. The system recognizes tiie dash as a continuation diaracter and asks 
you (in a message) for f urtiier input. You can use as many lines of tiie screen as you 
want; just place a dash at the end of eveiy line except the line on which the parameter 
string ends. 

Note: The PUNCH command punches only fixed4ength, 80-character records. If 
your file has records with more than 80 characters and you use the PUNCH 
command, the records are truncated. 

The PUNCH command is divided into the following five formats: 

Format 1 (PmiAmg a Libraiy Module) 



PUNCIlAMQDULE=>rodjil 



JYFE- 



f modjie-type 

ii 



} 



,FILEMAME= 



f!l« 

•fU< 
"fflenane" 



C,RDPASS],ySM^0li 



, COPIES- f n 1 

- ill I 



ACDIRECTJC.^AIT] 



Command Options 



DIRECT 



Specifies tiiat an actual punch is assigned to punch tiie file requested in the 
command. When DIRECT is not specified, the file requested will be copied 
to a spool file. The file is punched when a punch becomes available. If 
DIEECT is specified and no punch is available, you will receive an error 
message at the workstation. The default condition is that the file be spooled. 
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WAIT 

Specifies that control is not returned to workstation mode until the PUNCH 
command has completed execution. Normally, when you issue a PUNCH 
command, a background task is created, and the PUNCH command executes 
as a background job J allowing you to continue to use workstation mode for 
user or system programs. However, there are times when you want to be 
sure the PUNCH operation completes successfully before going on with your 
program, such as when you are making a backup copy of a file. In this case, 
entering the WAIT ke3rword with the PUNCH command stops the 
workstation mode until the command has completed execution. 

Format 2 (Ptmcliiiig a MffiAM Data FRe) 



PUNCHAFILEMAME= 



filename 
' f 1 1 ename ' 
"filename" 



, COPIES 



1"} 



,DEVICE= 



I , RDPASS=password] , VSMsvolune 



,KEYMO- r n 1 



did 

DISKETTE 

DISK 



A[DIRECT][,WAIT] 



Command Options 

Command options are the same as in Format 1. 
Format 3 (To Punch a Spool File) 



PUNCHACJOB=jobname] 




.FILENAME- | filename 
I 'filename' 
I "filename" 



C,ACCT=:ac£t] 



, QUEUED 



LOG 
EB-JNT 
PUNCH 
RDR 



,ALL= 



r YES 1 ^COPIES- r n 1 ,SK.IP- f n 1 



AEDIRECT]C,yAIT3 



Command Options 

Command options are the same as in Format 1. 
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Format 4 (Pmichmg a Tape- File) 



PUMCHA 



FILENAME: 



filename 
'filename* 

"filename" 



[ ,RDPASS=passHord] ,VSN-volume, DEVICE 



= r did 1 

1Iape| 



.BKMO- 



{ '^ } 



A[DIRECT]C,WAIT] 



Conunand. Options 

Command options are the same as in Format 1. 
Format 5 (Punching a Unit Record File) 



CHADEVICE- 


did 


.FILEHAME^ 


f i I ename 


,VSN=volume 




DISKETTE 




•filename' 






. ^DR 




"filename" 




A[DIRECT3[,1 


^AIT] 









Note^ The FILENAME- and VSN= parameters are required only when using a 
diskette. 

Command Options 

Command options are the same as in Format 1. 

Examples 

PUH FILENAHE=PAYFILE,VSN=D00063 

In this example, a punched card copy is made of a file name PAYFILE, located on 
volume D00063. 

PUN FILEMAME=PUHCHIT,QUEUE=PRIHT,C0PIES=5 

In this example, a punched card copy is made of the spooled file PUNCHIT, located in 
the PRINT spool file directory. Five copies will be made of the file. 
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The following conditions could cause tiie PRINT command to be rejected: 

® Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 

• Kle or Voliime Not Available 

Hie file or volume you. requested is not available for access. 

• Spooling Not Configured 

The spooling process was not configured at tiie time your ^stem was generated. 
Therefore, no spool files are available to access. 

® Punch Not Available 

There is no punch available to punch the requested file or module. The file or 
module is copied to a spool file and punched when a punch becomes available. 
Spool files remain in queue and are punched when a punch becomes available. 

® Invalid Password 

The password or passwords you entered are invalid. 

4.17, Displaying All or Part of tfie Work^ion Log File fRECALL 
Command} 

The EECALL command lets you display all or part of your workstation log file at your 
workstation or console screen. You can view selected portions of the log file by 
specifying a particular time span (for instance, from 9:00 to 10:00), Or^ you can 
indicate tiie number of messages^ prior to the most current one, that you'd like to see. 

If you issue the command from the qrstem console, tiie RECALL command only uses 
the lines that are available on the screen for the RECALL command. 

If you issue the command from a workstation that is free (tiiat is, not allocated to a 
job), the RECALL command uses the entire screen t© display the log file. If the screen 
fills up before the display is finished, the following qmtem message appears: 

m LRxxxx LR05 COMTIMUE? O OR M) 

To continue the display, key in the message prefix (nn) and Y. To end it, key in the 
message prefix (nn) and N. 



440 UP»9972 Rev. 2 



Utility Commands 



If your workstation is allocated to another job when you issue the RECALL command, 
the log file appears one record at a time on the second line of the system messages 
area of the screen. You must hit the XMIT key after each record is displayed in order 
to see the next one. 

If you are specifying a time period and you accidentally enter an invalid starting or 
ending time, the RECALL command displays the message: 

nn LRxxxx LR02 LIMIT IMVALID. CONTINUE? (Y OR N) 

If you key in Y, the RECALL command substitutes a default time in place of the 
invalid time you entered. If you key in N, you cancel the command and you're free to 
reenter it with the correct times. If you accidentally enter an invalid number of 
messages, the RECALL command ignores your entry and starts at the first message in 
the log file. 

Format 

, prefix, CON 



RECALLA r LASTAnn 

ss-hh;Fmi:ss 



r LASTAn 
I hh:mm; 

Command Parameters 



LASTAnn 

Indicates the number of messages in the log file that you want to see. The 
keyword LAST must be separated from the number of messages inn) by a 
space. 

hh;nim:ss-hh:nin:ss 

Indicates that you ¥/ant to see the contents of the log file for a particular 
time period. The minutes (mm) and seconds (ss) are optional. You must, 
however, separate the beginning time from the ending time with a dash (-). 
All time must be specified in military time. 

You can specify a beginning time without specifying an ending time. In this 
case, the log display starts at the time you specify and ends at the end of the 
log file. Similarly, you can specify an ending time without specifying a 
beginning time. In this case, the log display starts at the beginning of the file 
and ends at the time you specified. When keying in an ending time by itself, 
you must prefix it with a dash (-). 

prefix 

Indicates that you want to see messages within the specified time span with 
a prefix that starts with the indicated character. The prefix can be from 1 to 
8 characters long. 

CON 

Indicates that you want to view the console log from your terminal or 
workstation. You must have console viewing privileges as specified using the 
Security Maintenance Utility (SMU) to recall the console log. 
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Examples 

RECALL LAST 24 

In this example, only the last 24 log file entries are displayed. 

RECALL 15:30-16 

In this example, all the log file entries from 15:30:00 (3:30 p.m.) to 16:00:00 (4:00 p.m.) 

are displayed. 

RECALL 8:30 

In this example, the log file display starts at 8:30:00 (8:30 a.m.) and continues to the 
end of the file. 

RECALL -17 

In this example, the log file display starts at the beginning of the file and continues 
until the ending time is reached (17:00:00 or 5:00 p.m.). 

RECALL 1:00-3:00, FSTAT005 

In this example, all log entries from 1:00 (a.m.) to 3:00 (a.m.) with a message prefix of 
FSTAT005 are displayed. 

RECALL ,JOBX 

In this example, all m.essages in the log y/ith JOBX as the first 4 characters of the 

prefix are displayed. 

The following conditions could cause this command to be rejected: 

• Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered, 

® Logging Not Active 

Workstation logging is not active; therefore, no log file is created. Workstation 
logging is not active if you did not specify it at SYSGEN time with the 
CONSOLOG parameter or later with the operator's spooling command, SET SPL, 
CNSLG. 

Note: The RECALL command cannot span the time change at midnight; to use it 
from 23:00 to 1:00, you must use the RECALL command twice. 
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4.18. Recovering Deleted Modules (RECOVER Command) 

The RECOVER command enables you to recover deleted source, procedure, or macro 
modules in the SAT library. The command functions by listing, for the file specified, 

all deleted modules of the module type specified in the parameter you enter with the 
RECOVER command. Each module displayed is numbered, as well as being listed 
with its header comment and the date and time it was created. Modules that are not 
deleted, but have the same module name as that specified in the command 
parameters, are also displayed. These modules are displayed with an indicator to 
show that they are not deleted. 

When you have reviewed the complete display, the system allows you to choose one of 
the modules displayed and give it a new name. Renaming the module "undeletes" it. 
This command can also be used to rename modules not deleted. The new name you give 
the module must be unique; duplicates are not permitted. 

The RECOVER command can recover only the modules since the last LIBS PAC 
operation was performed. The LIBS PAC routine that reorganizes file space destroys 
all deleted modules. You must choose the module to be recovered carefully because the 
RECOVER display could show you several very similar modules. 

You can use the RECOVER command in an ENTER stream by observing certain 
special procedures. The RECOVER command requires three statements to execute in 
an ENTER stream. The first statement contains the RECOVER command and its 
associated file parameters. The second statement indicates which copy of the module 
specified by the file parameters you want recovered and the new name you want to 
give the recovered module. Entering a zero indicates that you want the most recent 
copy of the module recovered; a minus 1 (-1) indicates you want the next most recent 
copy; minus 2 (-2), the next most recent; etc. The third statement says STOP to end 
the RECOVER command. 

The following is an example of the use of the RECOVER command in an ENTER 
stream: 

REC MODULE-A,FILENAME=TEST,VSN=:PAC081 

-1, FIRST 

STOP 

Note,' Only one RECOVER command can be processed at a time. You cannot enter 
another RECOVER until the command currently being processed is 
completed. 

The RECOVER command issues a message to you, informing you it has completed 

execution. 
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You can use more than one line of the workstation screen to enter this command and 
its associated parameters by placing a dash (-) as the last character in the first line of 
the command. The system recognizes the dash as a continuation character and asks 
you (in a message) for further input. You can use as many lines of the screen as you 
want; just place a dash at the end of eveiy line except the line on which the parameter 
string ends. 



Format 



RECOVERAMODULE=qT!odu I ename 



.TYPE- J 



• 
module- type l 

1 


,FILENAME= 


filename 

'filenaue' 


^ 




"filename" 



t ,RDPASS=password] [ , WRPASS=password] J VSN=volume 

Example 

REC MODULE=A, F I LENAME^TEST , VSM=PAC00 1 

In this example, the user is seeking to recover source modules named A. The deleted 
modules reside in a file named TEST, on the PACOOl volume. Entering this produces 
the following displays: 



11 REC946 01 A 


COPY ONE 


80/02/15 


16;49 


12 REC946 02 A 


COPY TWO 


80/02/15 


16i49 


13 REC946 03*A 


COPY THREE 


80/02/15 


16:49 


14?REC946 IS56 ENTER • 


'ELEMENT-NUMBER, NEW-NAME" OR 


1 STOP < '- 




14 1, FIRST 








15 REC946 01 A 


COPY TWO 


80/02/15 


16:49 


16 REC946 02*A 


COPY THREE 


80/02/15 


16s49 


177REC946 IS56 ENTER ' 


•ELEMENT-NUMBER, NEW-NAME" OR 


'STOP" 




17 STOP 








18 REC946 IS90 RECOVER 


COMMAND TERMINATED NORMALLY 







Lines 1, 2, 3, and 4 are displayed after you enter the RECOVER command. They 
show all the modules that match the specifications you entered with the 
command. Line 4 is message IS56, asking you to enter either the element number 
or a new name for the module you want to recover, or STOP, to terminate the 
RECOVER command. Line 5 shows that the user has entered 1, FIRST. 
Therefore, the first module shown in the display will be recovered and renamed 
FIRST instead of A. In lines 6, 7, and 8, the RECOVER command displays the 
remaining modules matching the specifications entered with the command. On 
line 9, the user has entered STOP, terminating the RECOVER command. Line 10 
shows the message indicating that the RECOVER command has terminated 
normally. 
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If the user enters an FSTATUS command to display the modules in the file named 
TEST, he will see a display showing the recovered module now named FIRST: 



11 FSTAT456 FSTATUS FILEMAME=TEST,VSN=RES LONG 

12 FSTAT456 S-FIRST COPY QUE 80/02/15 16:49 

13 FSTAT456 IS83 FSTATUS FINISHED, 00001 ELEMENTS WERE DISPLAYED 



The following conditions could cause this command to be rejected: 

• Incorrect S5mtax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 

® No Deleted Modules 

There are no deleted modules in the file specified. 

® Attempt to Duplicate Existing Name 

In renaming a module in order to undelete it, you specified a name already in use 
by a module. The name you use must not be in use by a module that has not been 
deleted. 

® File or Volume Not Available 

The file or volum.e you requested is not available for access. 

® Invalid Password 

The password or passwords you entered are not valid. 
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4J9. Inserting a Comment in a Command Stream 
fREMARK Command] 

The REMARK command enables you to enter a comment in a stream of commands. 
This command is different from the COMMENT command, which enables you to add a 
comment to a library module header. The principal use of the REMARK command is 
in ENTER streams for batch processing, but it can be used in any situation to include 
a comment in a command stream. The command and text generate no output to the 
workstation. 

You can use more than one line of the workstation screen to enter this command and 
its associated parameters by placing a dash (-) as the last character in the first line of 
the command. The system recognizes the dash as a continuation character and asks 
you (in a message) for further input. You can use as many lines of the screen as you 
want; just place a dash at the end of every line except the line on which the parameter 
string ends. 

Format 

REMARKAtext 

Command Option 

text 

Is the text of the comment. The total length of the command and its 
associated text cannot exceed 60 charaters. 

Example 

REM THIS DECK EXECUTES PAY JOB 

In this example, the user is inserting a comment to indicate that the command stream 
referred to executes the program PAYJOB. 

The following condition could cause this command to be rejected: 

® Incorrect Syntax 

The command was misspelled or ambiguous. 
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4.20 Terminating User Tasks or Sessions (REMOVE Command) 

The REMOVE command terminates a single command, a specific workstation or 
terminal user session, or all user sessions. After the termination, a cancellation 
message is displayed on the terminated user's screen. 

Format 

REMOVE A f task- id 
user- id 
ALL 



where: 

task- Id 

Specifies the particular task under which a command is to terminate. The 
task-id can be determined using the STATUS FUNCTION command. 

user- id 

Specifies the particular user whose session is to terminate. User-ids can be 
determined using the STATUS TERMINAL command. All interactive 
functions for the user-id specified are terminated and the user is logged off. 
If the user is running an interactive session as a batch job (via ENTER), the 
user is logged off but the session is not affected. A message is displayed on 
the console workstation or console screen to indicate when the user cannot be 
logged off, 

ALL 

Specifies all user sessions and batch runs for each user-id that can be 
controlled by this user. All interactive functions are terminated and the 

users are logged off. Users running interactive sessions as batch jobs (via 
ENTER) are logged off. A message indicating which users cannot be logged 
off is displayed on the console workstation or console screen. 

Users that have global control priveleges can remove any task-id or user-id in the 
system. 
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4«21. Obtaining System Status Information 
, (STATUS Command) 

The STATUS command enables you to obtain information about various aspects of 
your system, including: 

Usage of terminals and workstations 

Number of jobs running on the system 

System storage resources in use and available 

Information on jobs running under your user-id 

Interactive commands and facilities being performed under your user-id 

STATUS can also give you a listing of the disk, tape, and diskette volumes currently 
mounted on your system, and the terminal name. This applies to all workstation 
t3^es5 local or remote. 

Format 



STATUSA 



TERMI^JALSE.u^d] 

RESOURCES 

JOBS 

FUNCTIO^JS 

VOLUMES 

LIMITS 



where: 
uid 



Specifies a user-id prefix of 1 to 6 characters to be used with command option 
TERMINALS. 



The output of the STATUS command depends on which, if any, of the command 
options you enter. 
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Example 



STA 



Entering the STATUS command witih no command option produces a display of your 
terminal-id, user-id, the current date and time, and tiie name of the job, if any, to 
which your workstetion is connected. 



terroinai-fd 



user- id 



niu/*/yy 



hhinn 



jobiante 



Example 

STA T 

Entering the STATUS command with tiie command option TERMNAI^ produces a 
display similar to the following: 



11 STATU678 TRM USER ID 


TRM USER ID TRH 


USER ID TRM 


USER ID 


12 STATy678 C14 USERA 


B8i1 JOE C53 


ANDY C11 


BETH 


13 STATU678 C16 BILLPR 


TRMS MIKE C42 


JIM C33 


CAROL 


14 STATU678 IS90 STATUS 


COMHAMD TERM I MATED 


NORimiLY 





where: 



TRM 



Is the physical device address of local workstations. It is the lo^cal name of 
remote workstetions and terminals assigned during ICAM generation. 

USER ID 

Is the user-id of the person currently lo^ed on at the workstation or 
terminal. 

The display shows 4 groups of terminals and user-ids across a line. TMs is useful in 
systems with many users logged on. 

When the system administrator, operator, or user with global status privileges issues 
a STA T command in a secure system, IS displays all the terminals at which at least 
one invalid logon was attempted. It also shows the number of logon attempts 
remaining for each terminal and the current limit. 
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If no invalid logons have occurred, it displays: 



MAXLOGON LIHIT IS CURRENTLY 



When someone has attempted an invalid logon, it displays: 



TRM 


LOGON TRIES LEFT 


C12 


3 


CMAXLOGONS) 


5 



Example 



STA T,EX 



Entering the STATUS command with the command option TERMINALS and the 
user-id prefix EX produces a display of the terminals where users with the user-id 
prefix EX are logged on: 



11 STATU007 TRM 


USER ID 


TRH USER ID TRM USER ID 


TRH 


USER ID 


12 STATU007 BA46 


EXAJB2 


BB46 EXSKL2 BA45 EXAJBI 


BB45 


EXSKL1 


13 STATU007 IS90 


STATUS 


COMHAMD TERHIMATED FORMALLY 







where: 



TRH 

Is the physical device address of local workstations. It is the logical name of 
remote workstations and terminals assi^ed during ICAM generation. 

USER ID 

Is the user-id of the person currently logged on at the workstation or 
terminal. 
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Example 

STA R 

Entering the STATUS command with the command option RESOURCES produces a 
display similar to the following: 



34 STATU011 BUFFERS IMT EMI BCK JOBSLOTS SYS-SIZE 

35 STATU011 566/503,952 011 000 001 05/48 8,388,608 

36 STATU011 1S90 STATUS COMMAND TERMINATED HORHALLY 



where: 



BUFFERS 

Shows the number of dynamic storage buffers allocated to interactive users, 
together with the total size (in bytes) of those buffers. The first number is the 
number of buffers; the second, the total size. 

INT 

Shows the number of interactive tasks running on the system. 

ENT 

Shows the number of ENTER command streams being run on the system. 

BCK 

Shows the number of background (batch) tasks running on the system. 

JOBSLOTS 

Shows, first, the number of system job slots in use; second, the number of job 
slots configured on the system. 

SYS-SIZE 

Shows the amount of main storage present in the system. This figure does 
not change unless more main storage is physically added to your system. 
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Example 

STA J 

Entering the STATUS command with the command option JOBS produces a display 
similar to the following: 



18 STATU678 JOBNAME 


SIZE CPU TIME 


STEP 


EXEC 


JOB NO 


MASTER 


19 STATU678 ASMBLY 


040,960 12.1 


01 


ASM000 


00012 


USERA 


20 STATU678 COBOLJOB 


073,862 125.6 


82 


COBOL0 


80015 


USERA 


21 STATU678 RPGLINK 


016,384 5.4 


01 


LNKEDT 


00016 


USERA 


22 STATU678 UNUSED MEMORY 0,388,352 




LARGEST 


REGION 


148,624 



where: 



JOBNAME 

Is the name of the job running on the system. 

SIZE 

Shows the amount of main storage, in bytes, being used by the job. 

CPU TIME 

Shows the amount of time the job has used the central processing unit. 

STEP 

Shows the number of the job step currently in execution. 

EXEC 

Is the name of the program (within the job) currently being executed. 

JOB NO 

Gives the job accounting number assigned to the job by the system. 

MASTER 

Shows the user-id of the master workstation controlling the job. 

UNUSED MEMORY 

Shows the total free main storage available. 

LARGEST REGION 

Shows the size of the largest free region of main storage. 
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STA F 

Entering the STATUS command witfi the command option FUNCTIONS produces a 
display similar to the following: 



14 STATU678 USER ID 


CWMAMD 


MODE 


ID 


STATUS 


15 STATU.678 USERA 


EOT 


I 


001 




16 STATU678 USERA 


PRIMT 


B 


002 




17 STATU678 IS90 


STATUS CCWMAND 


TERMIMATED NORMALLY 



where: 



USER ID 

Is your user-id. Only commands running under your user-id are displayed 
unless you have been given global status privileges by the system 
administrator. 

COMMAMD 

Lists by name the commands being executed. 



MODE 



ID 



Shows in which mode (interactive or background) the command is being 
executed. Some commendSj such as PMNT, can be executed as batch jobs to 
avoid tying up WORKSTATION mode for long periods of time while the 
command is executing. 



Is the internal task number assigned to the command by the system. 



A STATUS F command from the system console, ^stem administrator, or any user 
with global status privileges shows all functions active under interactive services. A 
terminal logging on or off has asterisks around the terminal-id rather than the user- 
id. 
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Example 



STA V 



Entering the STATUS command with the command option VOLUMES produces a 
display similar to the following: 



37 


STATU011 


D- 


COPROC 


D 


C0PR14 


D 


DBASE 1 


D- 


DB1R14 


D- 


ICHDEB 


D 


RUNLIB 


38 


STATU811 


D 


INTG01 


D 


PUB002 


D 


INT14A 


D- 


LSRSPL 


D- 


TIPRES 


D 


REL120 


39 


STATU011 


D 


ICMJAF 


D 


ADDEMT 


D 


R1307E 


D- 


SYSRES 


D 


R1407E 


D 


TIEF03 


40 


STATU011 


D 


ISWRK1 


D 


ISWRK3 


F 


KATHY1 














41 


STATU011 


IS90 STATUS 


COMMAND 


TERMINATED NORMALLY 









where: 



Prefacing the volume serial number with a D (as in D-REL070 in the sample 
screen) indicates that the volume is a disk volume. 



Prefacing the volume serial number indicates that the volume is a tape 
volume or a data set label diskette volume. 



Prefacing the volume serial number indicates that the volume is a format 
label diskette volume. 

Example 

STA L 

Entering the STATUS command with the command option LIMITS shows you the 
resource management limits currently in effect, plus actual current usage. The display 
appears in the following format: 



15 STATU678 JOBS WSJOBS 


SWSJOBS INTUSER 


EMTERS RUNSYMBS 


16 STATU678 xx/yy xx/yy 


XX xx/yy 


xx/yy xx/yy 


17 STATU678 SYMBMEM 


INTMEM 


JOBMEM 


18 STATU678 xx/yy% ssss/ssssK 


xx/yy% ssss/ssssK 


xx/yy% ssss/ssssK 
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where: 



JOBS 

xx/yy 

Shows you the actual number of jobs currently in execution (xx) versus the 
maximum number of jobs allowed to run concurrently (yy). 

ysjoBS 

xx/yy 

Shows you the actual number of jobs currently running that were initiated 
from workstations (xr) versus the maximum number permitted to run at the 
same time (yy), 

SWSJOBS 
XX 

Shows you how many jobs can be executed from a single workstation at any 
one time. 

IMTUSER 

xx/yy 

Shows you the actual numbers of users currently logged on to the system (xx) 
versus the maximum number of interactive users permitted at one time (yy), 

ENTERS 
xx/yy 

Shows you the actual number of batch sessions (ENTER streams) currently 
running (xx) versus the maximum permitted at any one time (yy), 

RUNSYHBS 

xx/yy 

Shows you the actual number of RUN sjmibionts currently active (xx) versus 
the maximum number permitted at any one time (yy). 

SYHBHEH 

xx/yy% ssss/ssssK 

Shows you the actual percentage of available main storage that symbionts 
are currently using (xx) versus the maximum percentage allowed by resource 
management (yy). In addition, it shows how much main storage these 
percentages amount to. The first ssss value is the amount actually in use; the 
second ssss value is the maximum amount permitted. (Amounts are given in 
Rvalues, where K=1024 bytes.) If no limits were set for symbiont memory, 
NL appears on the display. 
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INTMEH 

xx/yy% ssss/ssssK 

Shows you the percentage of available main storage currently used for 
interactivity ixx) versus the maximum percentage allowed by resource 
management iyy). In addition, it shows you how much storage these 
percentages amount to. The first ssss value is the amount actually in use; the 
second ssss value is the maximum allowed. (Amounts are given in Rvalues, 
where K=1024 bytes.) If no limits were set for interactive memory, NL 
appears as the value on the display. 

JOBHEM 

xx/yy% ssss/ssssK 

Shows you the percentage of available main storage your system is currently 
using to process jobs ixx) versus the maximum percentage allowed by 
resource management iyy). In addition, it shows how much main storage 
these percentages amount to. The first ssss value is the amount actually in 
use; the second ssss value is the maximum amoimt permitted. (Amounts are 
given in K values, where K=1024 bytes.) If no limits were set for job memoryj, 
NL appears as the value on the display. 



The following is a sample of a STATUS LIMITS display: 



20 STATU678 JOBS WSJOBS 


SWSJOBS 


INTUSER ENTERS 


RUMSYMBS 


21 STATU678 2/10 1/07 


1 


12/15 10/30 


1/01 


22 STATU678 SYMBMEM 


INTMEM 


JOBMEM 




23 STATU678 5/10% 30/60IC 


55/80% 330/480IC 


8/10% 48/60K 





This display tells you: 

There are currently two jobs running out of a possible 10 job slots. 

One of the jobs running was initiated from a workstation. This is one out of a 
possible seven jobs that can be initiated from workstations. 

A workstation user can run only one job at a time. 

Twelve users are logged on to the system out of a possible 15. 

Ten ENTER streams are currently running out of a possible 30. 

S3mibionts are currently using 5 percent (or 30K) of available main storage out of 
a possible 1 percent (or 60K)). 
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® Fifty-five percent (or 33010 of available main storage is being used for 
interactivity out of a possible 80 percent (or 480K). 

® Job processing is using 8 percent (or 48K) of available main storage out of a 
possible 10 percent (or 60K). 

The system administrator can obtain more information at Ms workstation than ttie 
other terminal users wi& the following commands: 

® STATUS JOBS 

The system administrator or global status' user entering the STATUS command 
with the option JOBS from the workstation is shown tiie status of all jobs 
running on the system, as well as the jobs he or she initiated. 

® STATUS FUN(3TI0NS 

The eystem administrator entering tiie STATUS command with tiie option 
FUNCTION from the workstation is shown all commands executing for all users 
on ttie system, as well as those for his or her user-id. 

® STATUS TEKMMALS 

The system administrator entering the STATUS command with the option 
TE^HNALS from the workstation is shown the status of all terminals currently 
logged on, plus a list of all terminals witii at least one invalid logon attempt and 
the number of tries each one has left 

The following condition could cause this command to be rejected: 

*' Incorrect Syntax 

The command was misspelled ©r ambiguous, or tiie command or parameters were 
improperly entered. 

4.22. Listing liie Contents of a VTOC |VTOC Command) 

The VTOC command enables you to produce a listing of the files present on a disk or 
diskette volume. The listing can contain all Ihie files on the volume, or just those 
whose -names match a prefix you specify with the command. For disk and format- 
label diskettes, the listing for each file gives the file name, file size and type, and 
extent information. After the last file has been listed, a count of free cylinders left on 
the disk or diskette is given. For data-set-label diskettes, tiie listing for each file gives 
the file name, tiie starting and ending addresses of each file, and tie file's block size 
and record size. 

Note: Only one VTOC command can be executed at a tim£. You must wait until the 
currently executing VTOC command finishes before entering another. 
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If you have issued an @SY VTOC command from tiie editor and you do not want to 
see the entire output of your VTOC listing, pressing function key 1 or 18 terminates 
the VTOC command and display an ED087 message. 

You can use more tiian one line of the workstation screen to enter this command and 
its associated parameters by placing a dash (-) as tiie last character in tihe first line of 
the command. The system recognizes the dash as a continuation character -and asks 
you (in a message) for fur&er input. You can use as many lines of the screen as you 
want; just place a dash at ttie end of eveiy line except the line on which the parameter 
string ends. 

Format 

VTOCAC ' f f ie-pref 1x« , ]VSi^oliJi«A[FREE] CSAT3 [MIRAM3CLONG3 

Command Options 

•file-preflx« 

Specifies a full file name (such as JOBDUMP) or a partial file name (such 
as JOB). If you enter a file prefix, the listing produced will show only those 
files whose file names match the prefix specified. This parameter must be 
enclosed in apostrophes. 

FREE 

Specifies that you also want a listing of each free extent available on the 
volume you are referencing. For disk and format-label diskette volumes, this 
parameter gives the size of each free extent in cylinders and tracks. For 
data-set-label diskettes, this parameter gives you tiie beginning and ending 
addresses, and size (in sectors) of each free extent. 

SAT 

Specifies that you also want a listing of percentage-use information for SAT 
file partitions. Only SAT files are listed when you specify this option. 

MIRAM 

Specifies that you also want a listing of the number of keys, number of 
records, number of deleted records and whether the file has recovery. Only 
MIRAM and IRAM files are listed when you specify this option. 



LOMG 



Specifies that you also want a listing of date/time information for the last 
access to the file and the last modification to the file. If tiiis option is 
specified for a nonsectorized device, IS displays a message that no 
information is available for the type of disk. 
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Examples 

1 . For a disk volume : 



VT RES FREE 



In this example, the VTOC command is used to produce a listing of the files 
present on the disk volume named RES (the system-resident disk pack). Since 
you specified the FREE option, you will receive a listing of the size of each free 
extent. The following display is produced: 



42 VTOC011 




)C OF 


SYSRES 


DEV=3A2 


TYPE^ 






^i§fWW^i^il?^Wi^^Wi^1^ SlfC 


"S4'94' ■^'^^^^^ 


f^Wilr'&W^^W^^ 


43 VTOC011 


















44 VTOCiH 


FILENAME 


TYPE 


EXT 


CYL 


BKSZ 


RCSZ 


CRE-DATE 


EXP -DATE 


45 VTOCill 


















46 VT0C811 


SVTOC 


MIMM 




1 


256 


256 


89/05/29 


99/99/99 


47 VTOCill 


$!PL 


MI RAM 




1 


256 


256 


89/05/29 


99/99/99 


48 VTOC011 


SHCFILE 


SAT 




1 


256 


256 


89/85/29 


99/99/99 


49 VT0C811 


$Y$DUMP 


Ml RAM 




18 


256 


256 


89/06/05 


89/06/95 


50 VTOC011 


SGSJCS 


SAT 




2 


256 


256 


89/05/29 


89/05/29 


51 VT0C811 


SYSJCS 


SAT 




3 


256 


256 


89/05/29 


99/99/99 


52 VTOCiH 


SYSLOD 


SAT 




52 


256 


256 


89/05/29 


99/99/99 


53 VTOC011 


$YSFDY 


SAT 




1 


256 


256 


^ 89/05/29 


89/85/29 


54 VTOCill 


$YSOBJ 


SAT 




3 


256 


256 


89/05/29 


99/99/99 


55 VT0C811 


$Y$MAC 


SAT 




9 


256 


256 


89/85/29 


99/99/99 


56 VTOC® 11 


$YSSRC 


SAT 




4 


256 


256 


89/05/29 


99/99/99 


57 VT0C811 


SYSTRAN 


SAT 




3 


256 


256 


89/05/29 


99/99/99 


58 vTocen 


SYSlRhUh 


SAT 




3 


256 


256 


89/05/29 


99/99/99 


59 VT0C811 


SYSELOG 


MIRAM 




1 


256 


256 


89/85/29 


99/99/99 


60 VT0C811 


$Y$ESLW 


Ml RAM 




2 


256 


2384 


89/05/30 


89/05/38 


61 VTOCeil 


SYSSHR 


SAT 




1 


8 


9 


m/m/%9 


99/99/99 


62 VTOCeil 


SYSSYSTEMTMLES 


MIRAM 




1 


256 


256 


89/85/29 


99/99/99 


63 VTOCill 


$Y$MIC 


SAT 




2 


256 


256 


89/85/29 


99/99/99 


63 VTOC011 


SYSSCLOD 


SAT 


2 


4 


256 


256 


89/85/29 


99/99/99 


65 VTOCeil 


$Y$FMT 


HIRAM 


2 


16 


256 


256 


89/05/29 


99/99/99 
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If the VTOC listing requires more than 24 lines to display, tiie listing continues to 
roll up from the bottom of the screen, and some ©f the initial Hstin^ ©f the ¥TOC 
roll off the screen. 



66 VTOC011 


$Y$SAVE 


Ml RAM 


2 


2 


256 


256 


89/05/29 


99/99/99 


67 VTOC011 


SYSDIALOG 


mkm 


2 


3 


256 


256 


89/05/29 


99/99/99 


68 VTOC® 11 


$Y$SDF 


Ml RAH 


2 


2 


256 


256 


89/05/29 


99/99/99 


69 VTOC011 


$Y$HELP 


MI RAM 


2 


1@ 


256 


256 


89/05/29 


99/99/99 


70 VTOC011 


IVPLI8 


SAT 


1 


2 


256 


256 


89/85/29 


99/99/99 


71 ¥TOC011 


SGSXXX 


SAT 


1 


1 


e 


9 


e@/0e/ei 


99/99/99 


72 VTOC® 11 


SYSSHCLOG 


MIRAM 


2 


2 


256 


58 


89/05/29 


89/95/29 


73 VTOC011 


SGSOBJ 


SAT 


1 


4 


256 


256 


89/05/29 


89/85/29 


74 VTOC011 


SGSMAC 


SAT 


3 


9 


256 


256 


89/15/29 


89/05/29 


75 VTOCill 


SGSLOD 


SAT 


1 


1 


256 


256 


89/15/29 


89/15/29 


76 VTOCill 


SYSCAT 


SAT 


1 


1 


256 


256 


89/85/29 


99/99/99 


77 VIOC011 


$Y$SHF 


HIRAM 


1 


1 


256 


256 


89/05/29 


89/05/29 


78 VTOC011 


SYSLOG 


SEQ. 


4 


5 


256 


256 


89/B6/i2 


99/99/99 


79 VTOC® 11 


OUT LOG 


Il,l„ 


4 


5 


256 


256 


89/06/05 


89/06/aS 


80 VTQC011 


ESCSESCORT 


.LIBRARY. FILES 














81 VTOC011 




HIRAM 


1 


2 


256 


256 


89/86/i1 


89/06/01 


82 VTOC011 


SMCW0RK 


SAT 


1 


1 





9 


%%/m/m 


00/00/00 


83 VTOC011 


SMCBSAT 


SAT . 


2 


2 


256 


256 


89/86/83 


89/06/03 


84 VTOC011 


SMCBMIR 


HIRAM 


1 


1 


e 


e 


ae/de/ee 


80/00/00 


85 VTOC011 


SMCBTRA^ 


SAT 


1 


3 


e 


e 


i0/0@/8i 


90/00/00 


86 VTOC011 


















87 VTOC011 


FILENAME 


TYPE EXT 


CYL 


BKSZ 


RCS2 


CRE-0ATE 


EXP -DATE 


88 VTOC011 


FREE SPACES 


CYLIMDERS 448, 


TRACKS 


8@0 








89 VTOC011 


















9i VTOCill 


TOTAL FREES 


CYLS 448, TRKS 


089 




VSNsSYSRES 


0EVs3A2 TYPE*8494 



This display concludes the disk volume RES VTOC listing, ^e count of free 
cylinders is visible at the bottom of the display. 

On the display: 

• FILENAME gives the name of the file. 

• TYPE gives the type of file, that is, the access technique used to create the 
file. 

• EXT gives the number of extents that, together, make up the file. 

® CYL gives the size of the file in total number of cylinders composing Ae file. 
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® BKSZ gives the size of the block written to the file. 

® RCSZ gives the size of the records which make up the file. 

® CRE-DATE gives the date when the file was created. 

® EXP-DATE gives the expiration date of the file. 

2. For a catalogued file that resides on the disk with a vsn of PUB002: 

VTOC '$Y$SEC' 

In this example, the VTOC command is used to produce a listing showing the 
current file information and the volume serial number of the disk where the file 
resides. 



91 VTOC011 










t** VTOC OF PUB002 DEV=294 




92 VTOC011 








93 VTOC011 


FILENAME 


TYPE EXT CYL SiCSZ 


RCSZ CRE-DATE EXP-DATE 


94 VTOC011 








95 VTOC011 


$Y$SEC 


HIRAM 1 5 256 


256 86/02/18 86/02/18 


96 VTOC011 








97 VTOC011 


TOTAL FREE; 


CYLS 087, TRKS 000 VSN=PU8002 DEV=294 TYPE=8470 



3. For data-set-label diskettes: 

VT MYVOLI FREE 

In this example, the VTOC command is used to produce a listing of the files 
present on the data-set-label diskette volume named MYVOLI, Since the 
command includes the FREE option, the listing shows the size of each free extent, 
along with the starting and ending addresses of each extent: 
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FILENAME 




START 


OF 




END 


OF 


END OF 


BLOCK 


RECORD 






FILE 






FILE 


DATA 


SIZE 


SIZE 


FIL1 




01 





01 




02 1 


22 


01 01 


128 


128 


FIL2 




02 


1 


23 




07 1 


12 


02 1 23 


256 


256 


FIL3 




07 


1 


13 




13 


26 


07 1 13 


256 


256 


FIL4 




13 


1 


01 




14 


24 


13 1 01 


256 


256 


AM 




44 





08 




63 


19 


44 08 


128 


128 


FIL6 




15 





16 




24 1 


21 


15 16 


256 


256 


TST 




63 





20 




65 


15 


63 20 


128 


128 


FREE EXTENTS 


START 






1 


END 




SIZE (IN SECTORS) 






14 


25 






15 


15 




43 








24 


1 22 






44 


07 




1000 








65 


16 






74 


1 26 




505 






IS90 VTOC 


COMMAND 


TERMINATED NORMALLY 







On the display: 

® FILENAME gives the name of the file. 

® STAET OF FILE gives the diskette address where the file begins. The 
format is track-side-sector. 

• END OF FILE gives the ending diskette address for the file. 

® END OF DATA gives the diskette address of the last sector to be used for 
data within the file. 

® BLOCK SIZE gives the size of the block written to the file. 

• RECORD SIZE gives the size of the records which make up the file. 

The FREE EXTENTS information at the bottom of the display is listed because 
the FREE option was specified. This display shows the following: 

• START gives the diskette address where the free extent begins. The format 
is track-side-sector. 

® END gives the ending diskette address for the extent. 

• SIZE gives the number of sectors available in this extent. 
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4. When you want SAT, MIRAM, and LONG listings, the command: 

VT ,$Y$S,RES 

lists disk volume RES VTOC information for files with the prefix $Y$S: 



52 VTOC00a 




***** 


VTOC OF REL120 


DEV=3A2 


TYPE=84< 












53 VTOC008 






















54 VTOC008 


FILENAME 






TYPE 


EXT 


CYL 


BKSZ 


RCSZ 


CRE-DATE 


EXP -DATE 


55 VTOC008 






















56 VTOC008 


$Y$SRC 






SAT 


4 


6 


256 


356 


89/03/19 


99/99/99 


57 VTOC008 


$Y$SHR 






SAT 


1 


1 








00/00/00 


99/99/99 


58 VTOC008 


$Y$SYSTEMTA8LES 




MI RAH 


1 


1 


256 


256 


89/03/19 


99/99/99 


59 VTOC008 


SYSSCLOD 






SAT 


2 


4 


256 


356 


89/03/19 


99/99/99 


60 VTOC008 


$Y$SAVE 






MI RAM 


2 


2 


256 


356 


89/03/19 


99/99/99 


61 VTOC008 


$Y$SDF 






Ml RAM 


2 


2 


256 


356 


89/03/19 


99/99/99 


62 VTOC008 


$Y$SMCLOG 






MI RAM 


2 


2 


256 


50 


89/03/19 


89/03/19 


63 VTOC008 


SYSSMF 






MI RAM 


1 


1 


256 


356 


89/03/19 


89/03/19 


64 VTOC008 






















65 VTOC008 


TOTAL FREE: 


CYLS 


412 


, TRKS 


000 




VSN=REL120 


DEV=3A2 


TYPE=8494 



The command 

VT ,SY$S,RES L 

lists the same files with last-access and last-modification information: 



66 VTOC008 

67 VTOC008 




















VTOC OF RELINK 


DEV=3A2 TYKt-s^yif 






68 VTOC008 


FILENAME 




LAST ACCESS 


LAST MODIFICATION 




69 VTOC008 






DATE 


TIME 


DATE 


TIME 


JOB/CUID) 


ACCESS 


70 VTOC008 


















71 VTOC008 


$Y$SRC 




89/05/11 


09:03 


89/05/10 


09:24 


(EXJPF1) 


EXC 


72 VTOC008 


$Y$SHR 
















73 VTOC008 


$Y$SYSTEMTABLES 


89/03/19 


11:53 


89/03/19 


11:50 


SETREL 


EXC 


74 VTOC008 


SYSSCLOD 




89/05/11 


08:22 


89/05/10 


17:08 


CISJLS1) 


EXC 


75 VTOC008 


$Y$SAVE 




89/05/07 


07:48 


89/05/07 


07:45 


JC$SSV00 


EXC 


76 VTOC008 


$Y$SDF 




89/05/11 


08:28 


89/03/19 


12:20 


COPYREL 


EXC 


77 VTOC008 


$Y$SMCL0G 




89/05/08 


13:04 


89/05/07 


07:48 


SMC 


EXC 


78 VTGC008 


$Y$SMF 




89/05/11 


08:21 


89/05/11 


08:21 


SL$$SM00 


EXC 


79 VTOC008 


















80 VTOC008 


TOTAL FREE: 


CYLS 


412, TRKS 


000 


VSN=REL120 DEV=3A2 TYPE=8494 
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The command 

VT ,SY$S,RES M 

lists only the MIRAM and IRAM files in disk volume RES: 



81 VTOC008 




.120 


DEV=3A2 








TYPE=:8494 *^ 




82 VTOC008 














83 VTOC008 


FILENAME TYPE 


EXT 


CYL 


KEYS 


RECS 


DELETED RCVRY 


84 VTOC008 














85 VTOC0@8 


$Y$SYSTEMTABLES MIRAM 


1 


1 





1 




86 VTOC808 


$Y$SAVE MIRAM 


2 


2 


1 


267 





87 VTOC008 


SYSSDF MIRAM 


2 


2 


1 


81 





88 VTOC008 


$Y$SMCLOG MIRAM 


2 


2 


1 


810 





89 VTOC008 


SYSSMF MIRAM 


1 


1 





38 




90 VTOC008 














91 VTOC008 


TOTAL FREE: CYLS 412, TRKS 


000 




VSN=REL120 DEV=3A2 TYPE=8494 



The command 

VT ,$Y$S,RES S 

lists only the SAT files in disk volume RES with percentage use information: 

















92 VTOC0@8 

93 VTOC008 






VTOC OF RE L 120 


QE\'-iRd iTrt=o4VH 




94 VTOC008 


FILENAME 




TYPE EXT 


CYL 


%DIR %DATA %THIRD 


AVAIL. 


95 VTOC008 














96 VTOC008 


$Y$SRC 




SAT 4 


6 


14 98 





97 VTOC008 


$Y$SHR 




SAT 1 


1 








98 VTOC008 


$Y$SCLOD 




SAT 2 


4 


20 79 





99 VTOC008 














11 VTOC008 


TOTAL FREE: 


CYLS 


412, TRICS 000 




VSN=REL120 DEV^3A2 


TYPE=8494 
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The following conditions could cause the VTOC command to be rejected: 

• Incorrect Syntax 

The command was misspelled or ambiguous, or the command or parameters were 
improperly entered. 

® Volume Not Available 

The volume you requested is not available. 
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Section 5 

Quick-Reference Guide to the 
Interactive Facilities, 
Distributed Data Processing, 
BASIC, and ESCORT 



The inf ormatioii in tiiis section is for quick reference only. Use it to refresh your 
memory of ttie commands and functions available through tiiese f adlities. For 
complete and detailed information on the use of DDP, BASIC, ESCORT, and tiie 
interactive facilities, refer to the appropriate user guide. You will fmd a list of fliese 
guides in the "About Thie Guide" section. 

This section includes information on the following OS/3 f adHties: 

• Screen format services 

• Menu services 

® OS/3 interactive data utiMties 

• Interactive dump/restore hardware utility 

• General editor (EDT) 

EiTor file processor 
- RPG II editor 
COBOL editor 

• Distributed Data Processing (DDP) 

• BASIC 

® ESCOKT 

Another interactive fadlity^ interactive job control stream preparation, is discussed in 
2,2. 
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5,1. Screen Format Serwices 

The screen format services allow you to create, modify, and use formatted screen 
displays in your programs. Screen format services consist of two software products: 
the screen format generator and the screen format coordinator. 

5« L 1 . The Screen Format Generator 

The screen format generator allows you to interactively create and modify formatted 
screen displays. You. lay out the format at the workstation and specify information 
concerning each field of the format. . To use the screen format generator, you first 
enter the RV command with the job name SFGEN: 

RVASFGEM 

When the system has processed your command, this screen appears: 



1. 


Function (1): 


1 CREATE 


2 CREATE - 


FRM 


3 HODIFY 


4 


DELETE 


2. 
3. 
4. 




5 SUQU 


6 LIST 




7 SPOOL 


8 


TERM I MATE 


Old Format: 


Format nana 


: C 




„_ ^ 






5» 


is in library: 


File nmrnt 


(SYSFMT 








) 


6. 

7. 




VoliS!«: 


CRES ) 










8. 
9= 


Ueu format: 


Format nait» 


: C 




_ _ > 






19. 


stored in library: 


File nmet 


C$Y$FHT 








) 


11. 




VoiiM^: 


CRES ) 










12. 


File *es not exist: 


Allocate: 


(802) 


cylinders 






13. 




Inere!!»nt: 


cei) 


cylinders 






14. 
















15. 
















16. 
















17. 
















18. 


♦Function keys are: 


F1 - GO TO 


HCME SCREEN 


F5 - BREAKPOINT 


SPC»L FILE 


19. 




F13 - HELP 






F14 - EXIT 


HELP 




20. 




F20 - RESTORE SCREEH 











This screen is called the home screen. It's always the first display presented when you 
activate the screen format generator. On it, you choose a function and indicate either 
where an old format resides or where a format you're creating will ultimately reside. 
If necessa:^, SFGEN will allocate file space for newly created formats. 



5-2 
Update A 



UP-9972 Rev. 2 



Quick-Reference Guide 



Once you complete tiie home screen, the next screen presented is the characteristics 
screen: 



1. 

2. 

3. 

4. 

5. 

6. 

7. 

8. 

9. 

10. 

11. 

12. 

13, 

14. 

15. 

16. 

17. 

18. 

19. 

20. 

21. 

22. 


SPECIFY THE GLOBAL CHARACTERISTICS FOR 


FORMAT xxxxxxxx: 




Error retry count; 
Alphabets 


C023 
CE^iGLISH 


) 






Lower case translation? 
Screen format is 


CD: 

CD". 


1 
1 


YES 2 NO 

ORIGINAL 2 


OVERLAY 


Screen erase/unlock option 


CDs 


1 
3 
5 


HONE 2 
ERASE 4 
CONDITIONAL 


REPLENISH 
UMLOCK KEYBOARD 
1 INDICATOR 


Transmit all -disregard cursor position? 
Social editing characters? 
Special display control? 


CD: 
CD? 
CDs 


1 
1 
1 


MO 2 YES 
NO 2 YES 
NO 2 YES 




Error nessage field to be defined? 
Display retention on all fields? 
Function CMmand keys to be defined? 


CD? 

ay. 

CDs 


1 
1 

1 


M0 2 YES 
MO 2 YES 
MO 2 YES 




Format has a non- displayed constant? 
Create COBOL copy roodjle? 


CDs 
<Di 


1 
1 


NO 2 YES 
no 2 YES 





On this screen, you provide general information about how your format will look and 
act. Certain selections, in turn, cause other screens, called optional screens, to appear. 
For example, if you entered (2) for SPECIAL EDITING CHARACTERS, the following 
display results after you transmit the characteristics screen: 



1. 
2. 
3. 

4. 

5. 

6. 

7. 

8. 

9. 

10. 

11. 

12. 

13. 

14. 

15. 



EMTER EDIT CHARACTERS 


IN PAREMTHESES TO BE USED 


FOR FORMAT xxxxxxxx s 


STAMDARD CHARACTER '. 


MEAMIMGs - CHARACTER TO BE USED 


% s 


currency syfii»l = 


= C$) 


. i 


*cisnal point = 


= C.) 


1 ' 


thousands ^nctuation = 


'■ CJ 


a . 


replacen»nt character • 


= (p) 


CR: 


credit on negative - 


■■ CCR) 


DBS 


debit on negative - 


= CDB) 


- "' 


replenish character = 


= C_) 


NOTE? Hake sure no s>i!fcoi is atfciguous with any 


valid picture string character. 
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After you supply all the information requested by the characteristics screen and by 
any optional screens that, were displayed, you are presented with a blank screen. This 
is the template screen, on which you. actually lay out the format you want to create. 
The following is an example of a screen format after the first template screen: 





PERSONAL CREDIT REPORT 


HME: 


/ /91 


ADDRs 




SOCIAL SECURITY s 


STATES ZIP: 


ACCOJMT MUMBERs 




PAST DUE AMOJMTs 




NEW BALANCES 


PAYMEMT DUE DATAs / / 



The screen format you have laid out is presented to you two more times to allow you to 
specify further information about each field within the format. If the screen format 
generator requires more information about a particular field, one or more dialog 
screens are presented, requesting further information. The following is an example of 
a dialog screen for the "social security" field of this screen format: 



1, 

2. 
3. 

4. 
5. 


SOCIAL SECURITY: 99919919999 










(FLDBieeS) is for field use of 


CD: 


1 


OUTPUT 2 mWl 3 BOTH 




Internal usage is 


ay. 


1 


DISPLAY 2 PACKED 3 BIMARY 


4 ZONED 


6. 
8. 


Internal length is: 


(885 








PLEASE INDICATE WHETHER OR MOT 


THE FOLLOWING ARE REQUIRED: 




9. 


Conditional display? 


CD: 




MO 2 YES 




n. 


Special display properties? 


CD: 




MO 2 YES 




11. 


Conditional retention? 


CD: 




NO 2 YES 




12. 


.Conditional protection? 


CD: 




MO 2 YES 




13. 


Field change notification? 


CD: 




MO 2 YES 




14. 


Range checking? 


CD: 




.MO 2 YES 




15. 


Special characteristics 


CD: 




MO 2 YES 




16. 
17. 
18. 


Non- default COBOL fielchane 


CD: 




UO 2 YES 




REPLACE ••!" IM THE FOLLOyiNG 


LIME 


WITH 


INSERTION CHARACTERS 




19. 


99919919999 
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When yom have finished creating the sereen format, it is automatically stored in 
either a file maintained by tiie screen format generator ($Y$FMr) or an alternate file 
tiiat yom specified on the home screen. 

If yom come to a step you do not understand when you are creating a sereen format, 
you can receive help in the form of screen displays describing each step of the format 
generation process. 

To receive tiie appropriate HELP screen for the step in which you are working, press 
the FUNCTION key and, while holding it down, press the key marked F13 or its 
functional equivalent. When you have finished studying the HELP screen and you 
want to go back to the step on which you were working, press the FUNCTION key and 
F14, or its fimctional equivalent. 

5.1.2. The Screen Format Coordinator 

The screen format coordinator retrieves screens you want to use in a program from 
the $Y$FMT file or alternate file and manages tiieir use in tiie program. To use a 
screen format in one of your programs, you must indicate in the program at what 
point the format is to be used and include a special statement in the job control 
stream of your program, alerting the system that you require screen format services 
in the program. Use the following job control statement to include sereen formats in 
your program: 



//[syntooU^USEASFS 



'{r} 



[format-fUe-lfd-1]/[format-fUe-ifd-2] 
format-file- Ifd 



[, initial -screen] 



C ^screen-format- l=alias-1,...jScreen-format-12=aliaS" 12] 



Parameteire 



[format-file- lfd-1]/[format-file-lfd-2] 
format-file-lfd 



Specifies the names for up to two screen format files. If you omit a format- 
file-lfd name, it is assumed that all screen formats used reside in $Y$FMT, 

initial -screen 

Specifies the first format name to be used in behalf of the user program. 
Use of this parameter depends on tiie program's language. 
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{r} 

Specifies the number of formats that are to reside m main storage for use 
wife a given file. You use this parameter if a job alternates between two or 
more formats. Including tMs parameter reduces FO activity needed to 
retrieve the format. Bie default value is 1. 

E , screen -format- 1=ai f as- 1 ... E ^screen- format- 12-ai las- 12] ] 

Specifies tihat a name otiier than the real format name is to be used to 
identify a format. You can include a maximum of 12 aliases. If you supply 
more than 12 aliases, your job control stream is rejected. Write each alias 
into tiie statement as follows: 

real - format -nmie=progran- format-nane 

Note: For complete information on the use of the semen format generator and 
screen format coordinator, refer to the Screen Poi^iat Services Technical 
Overview (UP-9977). 
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5.2. Menu Se^ices 

Menu services enable you to create and manage menus for use either with tiie MENU 
command or with a user program. There are two components in menu services: the 
menu generator and the menu processor. 

5«2 J. The Menu Generator 

The menu generator allows you to create your own menus interactively. You use it to 
create new menus and modify ©r display existing menus. A menu generator session 
begins when you enter the MENUGEN command: 

HENUGEM 

You then see this screen: 



Moei 

MENU GEMERATOR HME SCREEN MENU ' 

1. CREATE A MEW MENU HODULE 

2. HOD! FY AH EX I ST I HG MEMO MODULE 

3. DISPLAY AM EX I ST IMG MEMU MODULE 

4. END mm GENERATOR 

FOR HELP ON A PARTICULAR ITEM NUMBER, ENTER A QUESTION MARK 
FQLLOUED BY THE ITEM MUMBER C?#5. HELP FOR THE ENTIRE HEUU CAN 
BE ACQUIRED BY ENTERIHG A QUESTION MARK C?K 

ENTER SELECTION NUMBER 



If, for example, you want to create a menu, choose 1. The menu generator then leads 
you by means of menus and screens through tiiese steps: 

1. You identify the menu youVe creating. If, for instance, you are creating a menu 
named PAYMENU for use in system mode, you'd later call it witii this command: 

MENU FAYHEMU 

2. You tell the ^stem in what file you want to store ttie completed menu. In this 
example, you stored the menu named PAYMENU in $Y$FMT in SYSRES. 

3. You create tiie screen that appears when you call the menu. 

4. You create the action table which tells, for each item in the menu, what action 
the system takes, such as running a program or leaving the menu. 

5. You create tihe help screens that go along with ihe menu. 
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At this point in the session, you can modify menu PAYMENU, go on to create other 
menus, or end the session. The menu is then ready for use. 

5.2.2. The Menu Processor 

The menu processor is the partner of &e menu generator. The menu generator 
creates a menu and tiie menu proceeeor executes ite menu, Every time you call a 
menu, whetiier by the MENU command or from a user program, it is the menu 
processor that searches for tiie menu, displays it ©n your workstation screenj accepts 
your choice, and tells the ^stem what action to take in response to your choice. In 
addition, it retrieves and displays whatever help screen you can want. 

You call the menu processor automatically when you enter a MENU command in 
system mode. If the menu is linked to a user program, however, some job control 
statements are necessaiy, most importantly the USE statement: 



//CsynfcoUAUSEAMiNU 



file-ifd-l/nienu-file-lfd-Z 

fne»lfd"2 
-flle-ifd-1/ifiilii 
-fUeHfd-1 



[.Initial -menu] 



'{r} 



C, menu- 1-al las- 1,,..,!n©nu"12-aiias- 123 



where: 

ME^U 



Indicates that the program is to use a menu. 



•flle-Lfd-1/roenu-ffle-lfd-2 
$Y$FMT/n«nu-fUe-lfd"2 
rflle-ifd-1/iiHii 
•fUe-lfd-l 




Names up to two files to be seardied for menus. Any name you use must 
match an Ifd name specified in a previously defined device assignment set 
for a menu library file (always a MIRAM file). A menu-file-lfd is one to 
ei#it alphanumeric characters long. If you don't specify any^mig for this 
parameter, it is assumed that all menus reside in system format file 
$Y$FMT. When coding this parameter, remember the following: 

• If you omit $Y$FMT from $Y$FMT/me¥iu-fUe'lfd, then code: 



•ffle-ifd. 



M 



UP-9972 Rev. 2 



Quick-Reference Guide 



• If you omit $Y$FMT from menU'file-lfd/$Y$¥Mr, then code: 
■fUe-ifd/. 



inftiai-r 

Specifies tiie name of tiie first or only menu to be used by the program. 
Beeause user programs do not ttiemselves specify wHch menu is to be called 
to satisfy an input request, this parameter is used to specify the menu, 

rmn 

Specifies the number of menus to be resident in main storage at one time, in 
the range 1 to 255, The default value is 1. 

n»nu-n=alias-n 

Allows you to equate a menu name specified in an application program 
(alias) to a menu with a different menu name (given when the menu was 
created), A maximum of 12 alias name sets can be specified. The menu and 
alias names must each be from one to eight alphanumeric characters in 
length. 

Note: For complete information on creating and using menus, see the Menu 
Services Technical Overview (UP'9317). 
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5.3. The Interactive Data Utilities 

The OS/3 interactive data utilities enable you to interactively matntaiii tiie data files 
of your system. Through the data utilities, you can edit files^ transfer files between 
peripherals, and compare files. Data utilities offer you the following functions: 

Reblocking files 

Correcting fields within a record 

Rearranging fields witiiin a record 

Editing files while transferring them between peripherals 

Filing transfers between peripherals without editing 

Comparing files, with printouts of comparison disagreements 

The coirection function provides tiie following correction options: 

Selecting records for output 

Deleting records 

Inserting records 

Replacing records 



5.3. 1 . Initializing th© interactive Data Utilities 

The interactive data utilities are run as a user program, occupying a job slot. To 
initiate the data utilities, you must enter the RV command with the f oUomng 
parameters: 



R¥AiaDATA[Cnew-nane)][,,MEM-nnnnn][,ACT-acct-no] 



,DBG= 



{1} 



Parameters 



laOATA 



Is the job name that runs the interactive data utilities. 



SIO 
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(newna!») 

Specifies another job name for the interactive data utilities. Each job name 
must be unique. If new-name is not specif ied, the RV command appends a 2- 
digit niunber to the end of I@DATA to make the name unique. This permits 
more tiian one user to run interactive data utiHties concurrently. 

Specifies, in hexadecimal notation, the amount of main storage required for 
the data utilities function you want to run. The default value is 8000''^ 
(325767'^®), which is adequate for many of the data utilities functions, but 
certain fimctions, chiefly those involving disk or tape files, could require 
more. The formula to calculate the amoimt of main storage you need for 
each of the data utilities functions is in the Data Utilities Operating Guide 
(UP-8834). If the amount of main storage you specify or the default value is 
insufficient for tiie function you wamt to perform, the amount required for 
the function is displayed on the screen, and the data utilities terminates. 
You must then reinitialize data utilities and enter the correct amount of 
main storage. 

ACT-acct-no 

Specifies a 1- to 4-eharacter alphanumeric account number. 



DBG- 



Specif 



specifies that the data utihties run in the debug^g mode. This is used 
chiefly to provide documentation for User Communication Forms (UCFs). 

5.3.2. Using the Interaciwe Data Utilities 

The data utilities operate interactively by presenting you with a series of menu 
selection screens. These screens enable you to enter the information needed by the 
data utilities function you want to perform. When you enter the RUN/EV command 
to initialize the data utiHtieSj your workstation screen clears, and the first menu 
selection screen is displayed. The first screen asks you what you want to do: 



SCREEN 1 00801 




DO YOJ want TO 




1. 


■COPY OR PRIMT A FILE 




2. 


COMPARE TWO FILES 




3, 


COMVERT OS/4 FILES TO OS/3 DISK FILES 


4„ 


CONVERT A S/32-34 $ COPY DISKETTE 


5. 


HELP 




ENTER C1 THRU 5) | 




IF 


DURING THIS SESSION YOU 


WISH TO 


TERMIMATE TYPE FUNCTION 15 


CF15) 
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On the ENTER line, the numeral 1 occupies the space where you enter your choice of ■ 
1, 2, 3, 4, or 5. The default value is 1 on this first screen. If you want to specify 2, 3, 
4, or 5, you simply overwrite the 1. To send your choice to the data utilities program, 
press the transmit key. 

The next screen displayed to you is determined by your response to the first screen. 
In this way, the data utilities lead you through the preparation of the information 
needed to execute a particular function. If you select 1 , copy or print a file, the next 
screen displayed asks you to: 



IMPUT SCREEM 






Dusez 




PLEASE EMTER 


THE 


TYPE 


OF 


YOJR 


FRIHARY 


FILE-. 












1. CARD 












2. TAPE 












3. DISKETTE 












4, DISK 












EMTER (1 THRU 4) 


1 









The data utilities continue to 'direct you, through tiie menu selection screens, until you 
have entered all tiie information needed to perform the function you have selected. 
The data utilities then inform you that the session is finished and the function you 
selected is being executed. 

533. The HELP Function 

Option 5 of the first menu selection screen (5.3.2) is the HELP function. This option 
is available to you on many of the menu selection screens throughout tiie interactive 
data utilities. If you choose the HELP option, a display appears on the screen, 
explaining the terms used in the menu selection screen and the other choices available 
to you. 
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The HELP screens provide information when you do not understand the choices 
offered you. The HELP screens can also act as a quick refresher for a section of the 
data utilities with which you are not completely comfortable. The following is an 
example of a HELP screen: 



* * * TAPE HELP SCREEN DUH8411 * * * 

*^VSII" SPECIFIES THE VOLUME NUHBER CVOLl LABEL) ON THE TAPE VOLUME TO 
BE USED AS YOJR PRIMARY/SECONDARY FILE. THE VOLUHE SERIAL I^UHBER 
UNIQUELY IDEMTIFIES THE TAPE REEL TO THE OPERATING SYSTEM. IT IS 
WRITTEM INTERNALLY COM THE TAPE SURFACE) AND POSSIBLY EXTERNALLY 
(GEMERALLY ON A GUMMED LABEL). THE VSM CAMQl BE HORE THAN SIX 
ALPHANWERIC CHARACTERS AND THE FIRST CHARACTER MUST BE ALPHABETIC. 
IF THERE ARE LESS THAi SIX, TRAILING BLANKS WILL BE ADDED OM THE RIGHT. 

MEED MORE CIF ANY) HELP SCREENS? CY/N=CONTIMUE MORMAL PROCESSIMGJY 



Notice that this screen is TAPE HELP SCREEN DUH0411. Choosing the HELP 
option ©n the menu selection screen to which this HELP screen is coordinated gets you 
three HELP screens, each adding to the explanation of the choice on the menu 
selection screen. To view the next screen, simply press the XMIT key. On the line 
that asks NEED MOKE (IF ANY) HELP SCREENS?, the character Y, which causes 
the next HELP screen to appear, is the default value. When you have seen the last of 
each series of HELP screens, enter either Y or N and press the XMIT key to return to 
the menu selection screen. 

Notm This explanation of the OS 13 data utilities is presented to get you started in, 
using the data utilities interactively or to act as a reminder of the process of 
their execution. For the information you need to make more extensive use of 
the data utilities, refer to the Data Utilities Operating Guide (7004 4516). 
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5.4. The Interactive DUMP/RESTORE 
Hardware Utility (HU) 

The dump/restore hardware utility (HU) enables you to interactively initiate and 
control the DMPRST routine from your workstation. The DMPRST routine creates 
backup copies of your program and data libraries on disk, tape (including streaming 
tape), or diskette. To initiate the DMPRST hardware utility, key in the following 
command: 

HU 

There are no parameters associated with this command. Once the system accepts 
your command, the first in a series of screens appears at your workstation. This first 
screen is a menu where you select the function you want to perform. Depending on 
your system^ menu screen HUOOC (models 8 through 20) or menu screen HUOOD 
(models 7E and 50) is displayed. Menu screen HUOOD is shown here: 





HARDMARE UTILITIES 


HU09D 


1. 


mm? FILES FRW A DISKCS) 




2, 


RESTORE FILES TO A DISKCS) 




3. 


LIST FILES ON A BACKUP MEDIUM 




' 4. 


COPY FILES FRW DISK TO DISK 




5. 


UmE OF THESE 

EMTER SELECTIONS __ 





Depending on which number you select, an appropriate set of screens is displayed. 
You enter the requested information on each screen and DMPRST does the rest. 

You can request help with any screen by pressing ftmction key 13. If the help you 
need extends over more than one screen, press the 3MIT key to display the next 
screen. When the last help screen is displayed, press ftmction key 14 or the XMIT key 
to return to your current screen. 

For detailed information on the operation and use of the HU facility, refer to the 
System Service Programs (SSP) Operating Guide (UP-8841). 
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5.5. The General Edrtor 

The general editor enables you to interactively edit data and library files, as well as 
edit and write source programs. To initialize the general editor, you enter the 
following command from the workstation: 

EDTAt Initial cannand] 

When the system has processed your command^ it clears tiie workstation screen and 
displays the message EDITOR VEKION XX^ READY on tiie bottom of the screen. 
In Edition, it sets the current work-space Hne to 1.0000 and displays a start-of-entiy 
symbol (►) to accept EDT commands. If you enter an editor command with the EDT 
command, tiie editor processes tiiat command and tiien displays the appropriate line 
number based on &e action of ihai commend. Table 5-1 lists tiie commands available 
tiirou^ flie general editor, tiieir formats, and brief descriptions of flieir functions. 

Table 5»1. General Edftor Commands 



Gomnand 


Format 


Expioiation 


EDT Comands 


a 


a 


Line-mjrt^r [lner«i»nt]' 
■I- 


sjdata 1 
' coonaid ' 


Sets the current line nintoer and 
incronent for data and cannand lines 
keyed In at the workstation 


CHAUSE 


ac E«s©arch-strlng'C*n3] TO 'change-string* [*n] 


Replaces an existing string in the 
current Mork-space file with a new 
string 


£0^^ 


^0 I i Ine-raige] [ « search -string' [-n] ] 
TO destination 


Copies lines in the current york-spaee 
file to new line locations Mithout 
deleting the original lines 


DELETE 


80 Ciine-range]! 'search-string' C*n3] 


Erases specified lines fran the current 
york- space file 


FIHD 


aFIM • search -string'C*n 3 


Locates the first occurrence of a string 
in the work -space file and assigns its 

corresponding line nmtoer to the 
variable and the colum nini>ers of the 
first and last coltnns it occupies to 
C and ] respectively 



continued 
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Table &.L Genera! Editor Conmiands Ccont) 



Format 



Explanation 



EDT 



(cont.) 



FSTATUS 



To specify file parartseters for any file for which 
you want a list of modiies. Use this format: 



aFSCWDULE-roodjle- 

,FlLENAME=ffUenai 
■ 'fiieni 
."fli 

,VSM=voiun8 

, DEVI CE=f did. 






E=finodjie-type1 

is I 



3 .IIPE= 
[.RDPASS^assword] 



Creates in the work-space file a list of 
all nwdules contained in a specified 
progran library 



iMSERT 



ai 'change-string* [*n] 



Inserts a s^ciffed string Into lines in 
the current Mork- space file 



LIST 



at Cline-rangeM 'search-string* E*n]]CJMMEDIATE] 



Prints specified lines from the current 
work-space file on the printer 



MOVE 



m C line-range] [' 
TO destination 



■string* C*n]] 



Transfers specified lines to new line 
locations in the work -space file and 
deletes the original lines and line 
nunoers 



NUMBER 



iMU 



-string' [*n] [BY i 



t] 



Inserts sequence nuifcers Into input 
lines 



PR I Ml 



ap Cline-range]Psearch-string«[*n]] 



Displays specified lines fran the 
current work-space file on the 
workstation screen 



£!JMCfl 



apy CI ine-range3C 'search-string' [*n]][lMMEDIATE3 



Reprodjces specified line frMn the 
current iijork-spaee file on cards 



iEAD 



To read a SAT or MIRAM library mockile from disk or 
label diskette to the current Mork-space file use 
this format; 



aiEAD MODULE:=module-name , TYPE- r»djle- type! 

L i^' [ 

[.TRUMC=rYES| j ,FiLEMAME-ff i lenane 



Reads a copy of a library module or 
progran library into the work -space file 



continued 
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Table 5-L General Editor Commands CconU 



Comnand 



Format 



Explanation 



EDT 



Ccont.) 



Ccont «) 



I , RDFASS=password 3 , VSN=vo 1 1 
.DEVICE^fdjd 



KEY=start-col-noiend-coi-nQ 
KKEY-start-col -nosend-col -no 
SHOyAf irst-eol -nog iast-eoi -no 



To read a MIRAM data file from disk or format 
label diskette to the current work-space file 
this format I 



aS,EAD FREMAMEs 



file 
'fil 
"fil 



t sBgRASSspassword] 



.VSM=volun» 



. KEYMO ~fn' 



iSm^^-- 



did 



E.BFSZ^n] 



.TRUNC= 



PI 



KEY=start-c©l-r!osend-col-no 
KKEY-start-col-nosend-eoi-no 

SHOWAflrst-eoi -no; last-col -no 



To read a unit record file from a data set label 
diskette or fran the card reader, use this format; 



BREAD FILEMAME- 



file 
•fil 



jVSM=voliJiie 



,DEVICE^ 



did 

DISiCET TE 

RDR 



.im^c= 



W] 



KEY=start-col-no;end-col-no 
KKEY=start-c©l -nosend-col -no 
SHOWAf irst-col -noi last-col -no, 
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Table 5^1. General Editor Commands Ccont) 



Format 



Expl 



ion 



EDT 



Ccont.) 



MAD 
Ccont.) 



To read a file from a tape, use this formats 



SiE^D FREIIMIE- 



fUe 

Mil 

"fil 



^ , RDPASS=password] 



,VSN^olijne,DEVICE=fdid 



jmnc= 



m 



^. } '^H 



KEY-start-col-noiend-col-no 
KKEYsstart-coi -nosencl-coi -no 
SHOWM!rst-col-nodast-c©l-no, 



To read a file Iran the spool file to the current 
york-space file, use this formats 



^£EAD [JOBsj 



.iaLD= 



.FILENAME- 



flle 
^fil 
iifil 



tjAeCT^acct-no] 



LOG 
£3.1 ^T 
PUNCH 

RDR 



[#ISy,NC=rYESl A feEY-start-coi-nosend-col-no 
pHj lKKEY=start-cQl-nosend-col-n( 
-^ IsHpWAfirst'Coi-noilast-coi-i 



To read the sme nwdule or file last accessed through 
a previous BREAD or aWRITE COTinand, use this formats 

aREAD 

To read the sane nwdule or file last accessed through 
a previous BREAD or aWRITE conmand but read now with i 
KEY, KKEY, or SHOW paraneter or any valid EDT 
specified, use this format i 



aREADA jA [KEYsstart-col -no:end-col -n© 
raY-stapt-coi-nosend-col°no 
^0«Afirst-col»noslast-c©i-no. 

[valid EDT coranand] 
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Table 5"L General Editor Commands (cont) 



Format 



Explanation 



EDT 



Ccont.) 



REMOVE 



' search -string^C^n] 



Deletes a specified string from 
lines In the Hork-space file 



SEQUENCE 



aSEQ f ^ sequence -str I ng'C%] 



{* 



IBY incrM»nt 



Inserts secfjence ntnfcers Into 
existing lines In the current 
Mork" space file 



UPDATE 



aj [Llne-pange]t^search»string't*n]] 



Displays specified lines from the 
york- space file one at a tisre for 
you ta edit or change 



WRITE 



To Mfite the current york-space file to a SAT or MIRAM 
library roodjle ©n a disk or format label diskette, use 
this formats 



«ITE MQDULEsTOdule- 



.FILEMAME= 



file 
'fll 
«'fil 



*Il^E=r «»ciu i e ■ typel 



[,WPASS=^assword] 



Writes a copy ©f the current 
work-space file to a prograa 
library or data file on disk, 
diskette^ or tape, or to the spool 

file 



.DEVICE- I did 



,VSM=v©lune 



.C0NTl6=fpS| ILINCsJnlCRCSZsnJCSIZE^n] 

To Mrlte the current work -space file to a HIRAM data 
file on a disk or format label diskette^ use this 
format I 



MITE FILENAMES 



file 

*fil 
"fll 



CWPASSspassword] 



,VSNsvoliir« 



■^■"f} 



.DEVICE= 



did 
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Table 5-L General Editor Commands fconU 



CoOTnand 



Format 



Explanation 



EDT 



Ccont.) 



WRITE 

Ccont.) 



''""!}] [^=gi}]p 



.i^.o=p 



,KEYi: 



start-col-nosend-col-no 
(start-col -nosend-col -no. 



-no, roup L fCHG J) 



,SLZE=n rRCB^fYESl 
* SSSZ^ fn 1 



.ECFM=J1H1 

|var| 



,RCSZ=n 



[,BFSZ=n] 



To write the current york-space file to a unit record 

file (i.e., to the printer card punch or to a data set 
label diskette); use this formats 



aW^^TE FILEMAME= 



file 
"fil 



,VSM=VOlLTO 



.DEVICE^ 



did 
DISKET TE 

LEUMCH , 



IvarJ 



C.RCSZ=n] 



To write the current work-space file to a tape, use 
this format: 



^MR"E FILENAME- 



file 
'fil 
"ffl 



[^WRPASS-password] 



,VSM=volui^,DEVICE=rdid jC.BFSZ^n] ,BKMO=jYES 



,£CFM= 



FIXBLK 
VARUNB 

VAR8LK 
UMDEF 



C .RCSZ=n 



lOMn^fYESn 



,EXTEHD= 



W\ 
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Table 5-1, General Edftor Commands (contl 



Connand 



Format, 



Explanation 



EOT 



CcontJ 



CcontJ 



To write the current Mork- space file to the spool 
file, use this formati 

MITE [JWrj^iaKlLTOLD^jYESl I 



l-p 



.niEiwiffi^ 



fii 

•fii 

iifll 



E«MCT~acct-r»] 



.QUEUED 



PRIHT 
RDR 



f^IES^fn' 



To yrlte t© the sane nwAile or file last 

through a previous IREAD or a«ITE commas use this 

fonnati 

MITE 

To write t© the sane nwdiie or file last accessed 
through a previous BREAD or WRITE eonmand, hit 
written to noM with any valid EDT conrond specified, 
use this formats 



MITEAjAvalid EDT 



General Editor Variable 



ASSIGH 



SAS Gn- 



•string' C*n] 
nCxiy) 

On 
LENCn} 



Assiyis values to EDT variables 



DiSPLAY 



aoi 



^string* C*n] 
nCxiy) 

On 
LENCn) 



Displays a specified expression or 
the value of a specified expression 
from the Hork-space file on the 
workstation screen 



IF 



aiF. condition. 



aiF expression relation expression 



Permits an EDT 
procedure file 
executed based on 



or EDT 

to be 
condition 
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Table 5-L General Editor Commands fcont) 



Comnand 


Format 


Explanation 


General Editor Procedjre File Conmands 


DO 


aoo proc-nimter 


'PRIMT 
' ioPRINT 
ieVERT , 






Executes a proeedure file 


po 


QE 


Terminates proceckire file ^finition 


GOTO 


ac Jlaben 

line 


Permits branching within a 
proceAjre file 


INPUT 


aiMP file-paraneters 


■pRINT 1 
•ioPRIMT 
ieVERT J 




Loads and executes a procedjre file 


HOP 


WOP icmimntl 


inters extra line for branching or 
cOTn»nts into a proceckire file 


PROC 


aPRO Cproc-nuiijer] 


Begins procedure file definition 


RETURM 


aRET 


Terminates procedjre file execution 


General Editor Directives 


CHECK 


aCHE 


jOrFj 




Oetermines if processed lines are to 
be displayed on the workstation 
screen 


COBOL 


acoB 


Activates the COBOL editor 


£SPP 


aoR 


Deletes all lines in the entire EOT 
work- space file 


EFP 


aEFP 


Activates the error file processor 


FORMAT 


aFORMAT paraneter string (for RPGEDT) 
aFORMAT Cfor COBEOT) 


Used only Kith either RPGEDT or 
COBEOT. See the appropriate 
sutedltor manual for information 
on the aFORMAT directive. 


HALT 


aH 


Terminates the EOT session 


RPG 


aRPo 


Activates the RPG II editor 
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Table &•!. General Edtor Comtnands Ccont) 






Fomat 



Explanation 



General Editor Directives CcontO 



SET 



as CHAR-tab» character 

L 



,TABS=rc0l^uins| 



'U 



I,UME=iengthJ .iXCLUDE-Jexe I us ion- character 






-fexel 

^11 



£ , ATSI OM=caimmd- tr i gger 1 1 , COLOM-range - separator ] 
C .JiCOL^end-coiunin] LBOFFERsfreeord-sf zel I 

£ jWIDTM-device-size] C ,CLEM] rsjRIP^jMIll 

[ ioff/J 

t, DISPLAY] 



[^.sPU=pi«jJ 



fM-L=f|iiClf SCRDSPLYsTRUMCATE) 
liiiCif SCRDSPLYsFOLD) 
1-15 



' SCREEM ■ 


.LA^OJAGEs 






_J 




COOL 








LSPC J 





jRECEMTRYi 



-m 



.SCRFORMi^ 



Defines varfoys parai»ters to E0T 
that collectively make i^ ymir EOT 



SYSTEM 



aSY [iiorkstatl©n-c«mandJ 



Pennlts norkstatlon conniands to be 
issued Airing ai EOT session or 
tanporarliy returns you to systas 



EDT Screen 



BLOCK aet 



Displays a freefonn screen that 
lets you switch to block nwde for 
entering nwltiple cannands or data 
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Table 5»L General Editor Commands Ccont) 



Conmsnd 


Format Explanation 


EDT Screen Cawnands (cont.) 


lELP 


QUE [error ntessage co^] 


Displays help screens for any EDT 
error nwssages 


^RAMS 


aPA 


Displays a screen showing the 
parai»ters oi the aSET directive 
(those that make yp y«ir EDT 
environi!«nt) 


PRWPT 


aPROI Eedt connwd] 


Displays the EDT camwid metm screen 
or help screens for any of the EDT 
connands Ci^anlng EDT conandS; 
modifiers, directives^ procedjre 
file cewinandSs variables, and screen, 
conands} 


RESTORE 


aRES 


Returns you to the ^Int in your EDT 
session where you originally entered 
a screen connand 


MLL 


aRo 


Displays freefomi screens^ showing 
the EDT work-space file, where you 
can update lines or simply view them 



5.5 J. The Error File Processor 

The error file proeessor, or EFP^ is a siibroutine of the general editor. It lets you see 
errors in your source code immediately after fee language compiler has compiled your 
program. You don't have to wait for tiie printed listing from the compiler. As you see 
your erroraj you can correct tiiem ri^t at your workstetion, 

EFP has its own command set. Once it is roiming, it displays an error message 
together with tiie line of source code where the error owurs. You use the EFP 
commands to control iMs display. T© correct flie source code, you use regular EDT 
commands. 

Note: Before you can use EFP, you must specify an error file in your job control 
stream. You do this by specifying the i I PARAM ERRFR,^job control 
statement, the RPG Iljprocs, or the auto report jprocs. For details, see the 
user guide or programmer reference for the language you're using. 
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If youVe not already using the general editor^ you activate EFP by keying in: 

EDiaEFP 

If you are already in the general editor, clear the EDT workspace with the ©DELETE 
command and set the current line number and increment equal to 1 witii the @ 
command. Then key in: 

aEFP 

Once activated, EFP displays tiie following message at your workstation: 



EFFi01 VERSIOM n.n 

EFP9%2 EMTER ERROR-FILE MODULE -MAME.F I LE-HAME.VSU 

► 



The cursor is positioned on the line below the EFP002 message. "Hiere you enter the 
module name, file name, and volume serial number ©f your error file. Once you 
transmit this information, the next screen display is: 



EFP003 


ERROR F ILE=error-ii»djle-nM», error- fil« 


inane s 


vsn 




language"Coiip!ierj£{wplier-version,c0iipUatl©n 


■date J 


eOTpilation-time 


EFP004 


SOURCE FILEssource-roodule- 


no^, source - 


flleni 


me^vsn 




EFP005 


MODULE-souree -inodj i e - nane 






nnnn 


ERRORS 




progran- un i t - nanes 


(for FORTRAN 


users 


only) 





Lines 1 through 3 show you your error file libraiy, information about your 
compilation, and your source file library. Line 4 shows you the total count of 
compilation errors. 

At this point, you can begin displaying each error message and related line of source 
code by issuing an EFP command. 

Table 5-2 lists the EFP commands and their functions. 
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Table 5"2. Error Rie Processor fEFP| Commands 



Conmand 



Format 



Explanation 



m 



To correct and display COBOL and RPG II errors and 
FORTRAN IV errors for one source nwdule at a tlme^ 
use? 

aEFCX]ACprogram»unit-n««3A 

Cerror-rmgelA ['search -string'] 



Displays errors in your error file, 
along with the source lines that 
contain those errors 

Notes EFP Is both an EOT directive 
and an EFP camand. 

X specifies that any message and 
line of source code that is dis- 
played once will not be displayed 
again Airing the current EFP 

prografn-unit-naroe allies only to 
FORTRAH IV source mocijles containing 
nsjltiple progran units. Lets you see 
and correct errors for one progran 
unit ylthin your source rrodjle. 



To correct and display FORTRAM IV errors for 
corrpilations that process multiple source roodjles^ 



SEF SOJ source -modjle-r 



"file- 



error- range specifies the error 
nwssage nuntsers you wish to see. 
They can be a range of nutters or 
specific ni«i>ers. 

search-string specifies the types of 
error n^ssages you uish to see. You 
can specify up to 50 characters. 



source-mockile-nmse, source-file- 
nmm, and vsn refer t© the library 
where a specific source nwAjle that 
yeu want to correct is in your 
FORTRAN IV conpilatlon. 



Em 



SEF EMD 



Terminates the error file processor 



SUMMARY 



aEF SUM 



Displays an error file sunmary for 
the n»Ajle you're correcting 



The f ollowmg screens illustrate a typical EFP session. 

EDTaEFP 

You activate EDT and issue the EFP directive. 



EFP001 VERSIOM 8.0 

EFP002 EMTER ERROR- FILE MODULE -MAHE,F I LE-MAME,VSM 

► ERRHOD,MYERRFIL,RES 



EFP asks you for and you provide the name of your eiror file and where it resides. 
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EFP003 ERROR-FILE=ERRMOD,MYERRFIL,RES 
COBQL74,¥ERSIOII 8.i8/xx,81/09/04,10:27si4 
EFPai4 SOURCE FILE=FAYRQLL,MYFILE,MYV0L1 
EFP085 PAYROLL 



10 ERRORS 



EFP displays your error file's name and location, the name and location of your source 
f ile^ information about your compilation^ and the number of compilation errors. 



101.8000 ►SEFP 



You issue an EFP command to begin display of your error messages and their related 
source code, (101.0000 is the next EDT line number because the source code for 
PAYROLL occupies the first 100 lines of the EDT workspace.) 



ERR-001 ASSIGN CLAUSE MOT SPECIFIED IN SELECT SEMTEMCE. 

10.0000 SELECT PAY-REPORT-FILE 
182.0i80^ai 18 

10.0008^SELECT PAY -REPORT FILE ASSIGM TO PRINTER-UNITPR-VC 



The first eiror message and the line of source code it refers to are displayed (lines 1 
and 2). On line 3, you issue the EDT update command to change line 10 of your 
source code. On Hne 4, you make your correction. 



53.2. The RPG Editor 



The RPG editor is a subeditor of EDT. It enables you to interactively create programs 
in the RPG 11 programming language. The RPG editor offers three format types to 
accommodate all levels of programming experience. 

To initialize the RPG editor, enter tiie EDT command with the operand RPG as 
follows: 

EDTaRPG 
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When your command is processed, tiie screen clears and you receive the following 
display: 



RPGEDT 


VER # 












SELECT MODE (C) 














C = CREATE U = UPDATE 












SELECT FORMAT TYPE? 


CD 












1 = POSIT lOMAL 


2 = FORMATTED 




3 ^ 


FREE 


FORM 


SPECIF! CAT lOM TYPE 


DISPLAY? 


my 


Y 


= YES 


U = 


m 



The tiiree format types are geared to different levels of programming ability. The 
formatted type provides the most prompting and is easiest to use. The following is a 
formatted-type screen: 









LIME - 1.0000 


1 SEQUEMCE NUMBER; 


6 


FORH TYPE H 




7 CCWPILATIOM MODE? 




8 ERROR DUMPS 




9 OPERATOR COMTROLs 




15 DEBUG 1 




21 INVERTED PR! Nil _ 




26 ALTSEQ: _ 




31 BINARY SEARCH s 




40 SIGH HAMDLING; 




41 FORMS ALIGNMENTS _ 




42 INDICATOR INIT.: _ 




43 FILE TRANSLATIONS _ 




70 CCA NAMES 




74 SUBRKJTIHEs _ 

NEXT SPEC! F I CAT I OM TYPE, 


ST 


75 PROGRAM ID; 




, OR CMDs C ) 













The positional format type is for more experienced programmers; it offers less 
prompting and hence requires a more tiiorough knowledge of RPG IL 
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The following is an example of a positional format: 



LINE - 1,8088 



122344447 77 
1 6789516101238 45 



NEXT SPECIFICATION TYPE, ST, OR CMD: ( ) 



The third format tj^pe, the free-form format, offers no prompting and is geared for 
highly experienced programmers who want to create programs quickly. The following 
is an example of the free-form format: 



LINE 



1.@0@0 



12 3 4 5 6 
1 234567890 1 234567890 1 234567898 1 234567898 1 234567890 1 234567890 1 234 

1 1 1 

6 7 8 9 8 1 2 

5678901234567898123456789812345678901234567898123456789012345678 

ENTER ST, OR CMD: (___) 



The procedure for using the RPG editor to create a program is the same for all three 
format types. The RPG editor displays the forms necessary to create an RPG II 
program. After you have completed one form, the next will be presented until a 
complete program is written. 

For detailed information on the operation and use of the general editor and the RPG 
editor, refer to the General Editor (EDT) Operating Guide (7004 4599) and the Report 
Program Generator II (RPG II) Editor Operations Guide (UP-9981). 
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53 J. The COBOL Editor fCOBEDT) 

The COBOL editor, or COBEDT, is a subeditor of EDT. It enables you to interactively 
create programs in the COBOL programming language. 

The COBOL editor offers you two modes of operation: the ordered creation mode and 
the selective creation mode. The ordered creation mode is designed for the novice 
programmer; it prompts you tiirough certain steps in tiie creation process. The 
selective creation mode is for the more experienced user, who doesn't need prompting. 
COBEDT also allows you to use keyword abbreviations^ ei&er ones you define and/or 
ones COBEDT assigns. 

To activate tfie COBOL editor, enter tiie EDT directive witii the COBOL command as 
follows: 

EOTKWOL 

The first screen displayed is the option select screen, where you select your mode of 
operation, spedfy whether you will use abbreviations, and choose your continuation 
mode. 




Select Cr®atl«i Mo*i C2) 

Kreit® In COTOL Progrm Oreter 

2^Create Selected Portions ©f the COBOL Progr«n 
^revlatfois to te usedi C u 

imom Z^COBOL keywords 3^ser specified 4=Both (COBOL and user) 

Olspiay a»OL teyword or attravfatfoi file abbreviations CD l^io 2«Te8 

^revlatiw ffl« to te mM md/or written (1) 

1«llo 2^R@ad file 3«yrft© 4«Re8d and Mrfte file 

Enter ffi« na» C ......,»,»,«,,..»..»„»....,..........»». .) 

Enter file van C«...».».^ 
Contirwatfoo Co* iMM} 

NRM^Nomal contlmjation MD^Enter 

EDT Canmmdi ........ 
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If you choose the ordered creation mode (l)^ tiie screen where you enter your source 
code appears as: 



OS/3 EDT/C080L 



C«OL EDIT« C¥8«l/1}»0r*red Creatlwi Mode 



l*ntlflcatiai Divlsioi 
A B 
IDENTIFICATIOH DI¥ISIOM» 



PROGRAM- 10.. 
[AUTHOR. 



Llr 



[IHSTALLATIOM, , 
COITE-CMFILED. 
CDATE"yRITTEM,_ 
CSECURITY. 



Continuation C©* CMRM) [Mext icr@en Is Envlr©m»nt Division] 
MRM^Hormal Contlnuatlai SEL^Ent«r S«i®gtlve Creation Itote 
CMD«Enter EOT Camwid Moete COH^Dlsplay Control Oivlsloi Screen 

EOT Comwidi ,»..„,,»,.,».., »«,.».«.»«,»»,. .»,»,».». 
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If you choose the selective creation mode (2), the screen appears as: 



OS/3 EDT/COBOL 



COBOL EDITOR CV8,e/1 5 -Selective Creatfcn Mo* 



Standard COBOL Coding Form 



L ine nnnn . nnnn 



CIA B 



Continuation Cocte O 



) 



[Mext screen is standard COBOL 
coding formj 
li Continuation TMPsOisplay Creation Screen List 

CMD=EDT Connaxt nwde sss^Display Creation Screen sss 

Display wwww Verb Skeleton Screen RETsReturn to orctered rmde 

EOT 



As you transmit each line of source code, the COBOL editor checks your sjmtax and notifies you 
of any errors. In this way, you can eliminate syntax errors before you compile your program. 

For detailed information on the operation and use of the general editor and the COBOL editor, 
refer to the General Editor (EDT) Operating Guide (7004 4599) and the COBOL Editor 
(COBEDT) Programming Guide (UP-9974). 
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5.6. Distributed Data Processing (DDP) 

Distributed data processing (DDP) enables you to form a network of data processing 
systems in which all systems can, within the limits of proper security, access each 
other's files and ran jobs on each other while directing program output back to the 
remote system that originated the job. 

The distributed data processing fimctions of OS/3 are initiated by entering the 
following command: 

To perform the DDP fimctions, use the special set of commands shown in Table 5-3. 
Each command must be preceded by the DDP directive. For more information on 
DDP and more detailed information on the DDP commands, refer to the Distributed 
Data Processing Programming Guide (7004 4508). 

Table 5-3. DDP Comiiiancis 



Explanation 



DDPACREATEAFILE- [host- id 



file- id 



C SIZE= fr 



ABLOCK SIZE= fnnnnnnnnn 

256 



ADEMSITY- 



2@@ 
556 

1608 
6258 

[ho^ti5YS6EN:ioptili 



ADEVICE CLASS= 



TAPE 
DISKETTE 



AFILE TYPE- 



SEQUENTIAL 

INDEXED 

LIBRARY 

undeHed 



The CREATE 

■ Establishes a file on a receiving host 

® Allocates space for the file 

i Catalogs the file in your online 

system catalog 
i Records the file in the voltroe table 

of contents CVTOC) of the voiune at 

the r&mte host on which the file is 

created 

Note; The default for INCRENEMT SIZE and 
IMITIAL SIZE is three cylincters. 
If irore or less than three 
cylinders is needed, the size imjst 
be entered in ntmter of blocks 
Cnnnnnnnnn). 



AIHCREHEMT SIZE= fnnnnnnnnn] 

pirn 1 



AINITIAL_SIZE= fnnnnnnnnn 
3lcyt 
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Table 5-3. DDP Commands (conti 



Cosmiand 



Explwiatfoi 



MEY 



Efnl jaCsIze, location A fDUPLICATES 1 

EfCHMGE 1 
ppfflMj 



APMITTt 



[" 



MECOR0 SIZE 



[" 



{e¥Em| 

^ fnnrwml 
t» 1 



ARECORD FORM* pliii 

IVMIABLE 
luHOEFIMED, 



MEGISTER" 






0DPACW>YAFRO<s fsource 



Bsource-host-ldl ss 

1 



source- file- Id 



4TOs r*stjni_ation"ho8t-ldl s 



*stfnati©n-fUe-fd 



The COPY cannaid permits you to ccpy a 
file or nwdjie from orm systMi t© aiother. 
You may copy a file ©r rwciiie Iron one 
rarote systera to mother, frai your local 
systan to a renwte systas, ©r vice versa. 
You may also use the COPY cmmmyd t© c^y 
a file within your local systmu. 



MLEMEMI TYFE^ 



RELOCATABLE 

ABSOLUTE 

MACRO 

PR0C 

C«PILED_,JCM 

SCREEM FORMAT 



AKEY • fnl NCsfiej location A fDUPLICATES 1 



AMOOE^ 



MAIT 
IMDIRECT 



APOSITIOM* 



fCMANGE^ ^ 1 



ATRAMSLATE- 



ASCII 

mm 

MOliE 



continued 
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Table 5-3. DDP Commands Ccont) 



Explanatlai 



DDPAPUR6EAF 



lLE^rrh©8t-ld^^ ^^ 1 sT] file- Id 



The PURSE camiaid allows you to physically 
r«iove a fUe« and all references to Itj 
fron a host syst«n» 



DDPASUBMITAFILE-I f source -host- I dl ss file-Id 

if 




The SUBMIT cannand allows you to send a 
file of job control streans to a host 
systan for execution. You can also use it 
to initiate a file of job control streais 
airea^ at the host syston or to bring a 
job control streai to your local system 
for execution. 



DDPACAHCELA JOB- [host - 1 d 




AajTPUT= fii-Siil Uca«AMD= 

DELIVERJ 
york - order - nu*ep 



The CANCEL cotrmand allows you to terminate 
a job either executing or scheAiled for 
execution on a host system. 



DDPASUBM ITAREQUESTsstatement 



AHOST= 



rhost:j'd 1 



The SUBMIT REQUEST conmand allows you to 
send a stateinentj such as an operator or 
Interactive coranandj to a host systan. The 
f ©I lowing statarents (caimands) cannot be 
useds DISPLAY, DELETE, BREAKPOINT, FILE, 
IM, SO, TU, PD. 



DDPASTATOSA 



COMMAMDswork - orcter - njjrter 
FILE' 



■- rfhost ; i d ^^ ^ ] %% f 1 1 e - id 



[keyMord paraieter] 
HOST=host-id 



JOB= 



frhost-id 1 iTlj 



lobnote 



ySER= fhost-id 1 %', 

[jiiaiisHil 



user- id 



The STATUS conmand enables you to obtain 
information about s 

« Connands entered 

8 Host systans In your DDP system 

i Jobs you have sutaltted 

i Files In your DDP system 

* Other users on your DDP system 



DDPATALKAMESSAGE- ' string • 
AUSER-I Jhost-Jd 



1 IS JOPERATORl 
IJ |user-ld J 



[AMAIT] 



The TALK conmand allows you to send a 
message to a remote o^rator or user. 
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5.7. BASIC 



BASIC is a powerful, interactive programming language that you use through your 
workstation, BASIC programs cffli be written, executed, and modified from tiie 
workstation. 

To use BASIC, enter the following command: 

BASIC 

There are no parameters Msociated witii Ais command. 

When BASIC is ready for your use^ you receive the following message: 

BA801 OS/3 BASIC READYCVER x.x) BEGW 

You can now begin to enter tiie BASIC statements tiiat comprise your program, Eadi line 
is cheeked for correct syntax as it is entered. 



Note: For more detailed information on programming in BASIC, refer to the BASIC 
Programming Reference Manual (UP-9168). 



5.8. ESCORT 



ESCORT is an interactive programming language tiiat uses English statements to create a 
program. ESCORT enables you to ^nerate reports and perform inqmry and update 
routines through tiie use of simple, sentence-like programs, entered through your 
workstation. To use ESCORT, log on and then enter the following command: 



ESCORT 



There are no parameters associated wi& this command. The following display now 
appears on your workstation screen: 



We I cane to wi ESCORT to cociputers 
Please select your entry point: 

1 . The PROGRAM l!»de 

2. The TUTORIAL mode 

3. HELP - a brief description of ESCORT 

4. RECOVER 
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The inexperienced ESCORT user should use the tutorial mode of operation^ which makes 
ESCORT easy to leam right at the workstation. The following screen is an example of the 
ESCORT tutorial displays: 



**^ ESCORT TUTORIAL SESSION *^ 

A TUTORIAL SESSIOM IS PRIMARILY A QUEST I OM AMD ANSWER 
TYPE OF EMVIRONMEMT IN yHICH YOU RESPOMD BY SELECT IMG 
OME OF SEVERAL AVAILABLE OPTIOMS. OCCASIOMALLY YCXJ ARE 
REQUIRED TO PROVIDE BRIEF TEXT ENTRIES. 

BEGIN BY IDEMTIFYIMG THE PRIMARY PROGRAM FUMCTIOMi 

1. ENTER DATA FR« WORKSTATION 

2. CHAMGE DATA 

3. RETRIEVE DATA CSELECT) 

4. DELETE DATA 

5. SORT DATA 

6. HELP - EXPLAMATIOM OF OPTIONS 
* ENTER SELECTIOH NUMBER... 



ESCORT also offers help screens to explain the various statements and conventions it 
requires. For more detailed information on the use ©f ESCORT, refer t© tiie ESCORT 
Programming Language Programming Guide (UP-8855). 
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Interactiwe Dewices 

A J . Local/Remote Workstations and Terminals 

The devices used wiih interactive services include local and remote workstations and 
devices generated as terminals. 

The following devices can be used with interactive services: 

• Local workstations (not model 7E or model 50) 

- UTS 20D/40D 

SVT 1122 
® Remote workstations (not model 7E or model 50) 

UTS 20/30/40 

SVT 1123^124. 

PC using STEP 

UNIX® UNISCOFE emulator 
® Terminals 

UTS 20/30/40 

SVT 1120/1123/1124 

PC using STEP 

UNIX UMSCOPE emulator 

UNIX IS/5000 or IS/6000 (interactive mode) 

B2x using UNISCOPE emulator 

UNISCOPE 200/400 

UTS 4000 



UNIX is a registered trademark of AT&T Information Systems. 
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Table A-1 lists the procedures involved in comnmnicating with interactive sendees, 
and summarizes how each type of terminal performs each procedure. Subsections A.2 
through A.6 discuss Aese procedures in more detail. 



TabteA4. Procedyre Table 



ProeeAire 


Local 
Itorkstatlon 


^rkstation 


Terwfnai M©t 
Cair»cted to DCP 


Ttfwinal 
Cmmcfd to OCP 


Notes 


SSSCM 


NO 


MO 


YES 


YES 


See A„2 


LOGOU 


YES 


YES 


YES 


YES 


S«« k3 


SYSTEM p»* 


Press FUNCTION 
and SYS HOOE 
ktySj or press 
TRAMSMIT, 


Press FUHCTION 
and SYS MODE 
keySg OP press 
TRAIISMIT» 


Press MESSAGE 
yAlTIMG k@y. 


Press MESSAGE 
HAITING key. 


Sm A.4 




Press FUMCTIOH 
end ys WOE 
keyse 


Pre«8 FUMCTIOM 
and US MODE 
keys. 


Press TRAIiaiT» 


PrtM TRAMaiT» 


Save and 
restore SYS 
rwde lines 


YES 


YES 


NO 


MO 


Message 
waiting 
indicator 


SYS HSG 
displayed m% 
Indicator line. 


SYS MSG 
displayed m% 
Indicator ilrie^ 


MEiiAGE UAITIiG 
light f« lit. 
Audlbl* aiara 
smmds. 


MESSAGE yHITIiG 
light m lit. 
Audfbi« alarm 




LMOFF 


YES 


YES 


YES 


YES 


See A. 5 


$SSOFF 


NO 


NO 


YES 


YES 


See A.6 
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A.2. Signing On to ICAIVI 

For Wo AstetioMs 

Normally, you do not enter the $$SON commaBd to log on. from a direct-connected 
System 80 workstation. However, to connect the System 80 workstation to a program 
tiiat requires the use of tiie Integrated Communications Access Method (ICAM), such 
as the Information Management System (IMS), you must enter $$SON after logging 
on normally. At tiie conclusion of tihe session, you must enter $$SOFF before logging 
off the workstetion. 

Note: On devices with two xmens, when you are logged on to interactive services and 
signed on to ICAM on screen 1> you can sign on to ICAM from workstation 
mode on screen 2. In this case: 

® ICAM mesmges for screen 2 will appear in system mode on screen 1. 

® You can terminate your session on screen 1 using a $$SOFF command and 
continue to use workstation mode on screen 2. 

® A logoff is permitted while a screen 2 session is active. (When finished, 
you should $$SOFFfrom workstation mode on screen 2 J 



For De¥ice8 Generated as TermmalH 

In order to use the interactive facilities from a remote terminal, you must first 
connect the terminal t© your i^stem throi^h the ICAM terminal support facility. 
Since terminal identifications and file names vaiy from ^stem to system, you should 
consult your system administrator for particular information about your system. The 
following sections provide information on the standard terminal dialog and $$SON, 
the commMid provided by ICAM for connection, of remote terminals. The sign-off 
commandj $$SOFF, is described in A,6. 

When your sign-on to ICAM is accepted, you receive the following message: 

SESSION PATH OFEM 

When you receive this message, you can either go into SYSTEM mode and enter the 
LOGON command, or press TRANSMIT to request the LOGON menu. 
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A.2 J. Standard Dialog for ICAW-Connected Terminals 

The ICAM terminal support facility pro¥ides a commend processor module tiiat 
processes terminal operator requests to dynamically esteblish or end a 
communications session. The terminal operator enters si^-on or sign-off commands 
when it is necessaiy to communicate with a user program, a process file, or another 
terminal in ttie network^ or to end a session witti one of these. Standard terminal 
dialog is available with global networks that provide dynamic session establishment. 

On a tenninal not connected to DCP^ when the command processor receives a valid 
si^-on command, tiie message: 

UMISYS DCA NEiyOraC, LE^L I, I, MODE ID XXXX 

is sent immediately to ihe initiating terminal, 
where: 



1. 1 



Is the operating system release level. 






Is the global network node identifier you specified in tiie TYPE operand of 
the CCA macroinstruction in your network definition. 

After entering the sign-on command from any terminal, you might receive any of tiie 
following messages. 



Message 


Explanation 


SESSIOM PATH OPEM 


Your sign -on revest Is honored. 


SESSIOM PATH CLOSED 


Your revest for session establfshirent is rejected. 


SESSION PATH CLOSED 

$$OFF 


A res^est for sign-off (of an established session) 
has been Issued by another terminal or a user 
progran. 


SESSIOH PATH ABORTED 


Your progran has atorted an established session. 


IMVALID $$ COMMAND 


An Invalid coimsand was entered at a temlnal. 
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A.2.2» SIGN-ON Command |$$SON Commaod) 

This command enables you to establish a session with a user program, a process file, 
or another terminal. 

Format 

$$SON xxxxyyyy 

where: 

xxxx 

Is the logical name of the terminal used to issue this command, that is, the 
label of the TERM macroinstruction where you defined the terminal in your 
network definition. 

yyyy 

Is the logical name of: 

• A user program (as defined in the label of a LOCAP macroinstraction 
you defined in your network definition or the APPS operand of an 
NATTACH interface macroinstruction) 

® A process file (as defined in the label of a PRCS macroinstruction) 

® Another terminal (as defined in the label of a TERM macroinstruction) 

Note: When you generate ICAM on your ^stem, you can choose the option to sign on 
with a $$OPEN command. For more information, see the Integrated 
Communications Access Method (ICAM) Operations Guide applicable to your 
system. 

A.3. LOGON Procedure 

The LOGON procedure is discussed in depth in Section 1. This appendix describes the 
differences you see when moving from terminals to workstations. 



For Termmals 

After you apply power to the workstation, the screen displays tiie results of the power- 
on confidence test (POC). When the POC is complete, the word LOADING flashes on 
the indicator line. Then, the display shown in Figure A-1 appears on your screen. 



UP-9972 Rev„ 2 A-5 

Update A 



Interacti¥e Terminals 



ssss 


/ 
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3333333 


ssss 


/ 


3333 



liTERACTIVE WERATliG 
DEPRESS TRANSMIT FW 



FIgura A4» OS/3 LOGON Requert 



When Mb display appears, you can switch to SYSTEM mode and enter the LOGON 
commMid, or request tfie LOGON menu by pressing the TRANSMIT (XMIT) key. 

Note: You can change the OS 13 LOGON Request Screen by using the OS 1 3 logo ■ 
generator utility (LGEN command). See 4J3A for mx^re information about the 
0Sf3 logo generator utility. 



For I^cal Workstations 

The display shown in Figure A-1 appeare immediately and you can enter &e LOGON 
command from system mode or from the LOGON menu. 



For Remote Workstations 

When you apply power to the workstation, you see the message: 

UNISYS OS/3 INTERACTIVE OPERATIIIG SYSTEM S16N-0M PRESS TRAMWIT 

When you press transmit^ you get tfie LOGON menu. After you log on, you 
display shown in Figure A-1, 



the 
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A.4. Switching Modes 



You can issue workstation or interactive commands and respond to messages in 
system mode only. You can complete the LOGON menu and fill in data in workstation 
mode only. Table A-1 indicates how to switch between modes on each terminal. 



For Tenninals 

Be careful when you respond to a message; two lines of data are removed for system 
mode. This could cause serious program errors when you return to workstation mode. 
Use the screen SI=BOTTOM option to minimize errors (see 1.2.3). 



For Workstations 

The two lines of data removed for the system mode display are saved and then 
restored when you return to workstation mode. 

A3. LOGOFF Procedure 

When you have completed your tasks and want to end your interactive services 
session, enter the LOGOFF command as described in 1.8. After the LOGOFF 
ACCEPTED message is displayed, the OS/3 LOGON request screen is displayed. At 
this point, another user can log on to the system from your terminal 



For Terminals 

If you want to terminate the communications connection of the terminal, you must 
perform the standard terminal si^-ofF command, $$SOFF. See A6 for complete 
information on the sign-off command. 

A.6. SIGN-OFF Command ($$SOFF) 

This command requests d3mamic session disestablishment. You use it to end a 
dynamic session. 

If your terminal is connected to ICAM by means of a dial line and you issue this 
command, ICAM holds the telephone connection for 60 seconds after it has ended 
(disestablished) the session. Thus, you can issue a subsequent sign-on command to 
establish another session without redialing. 

Format 

$$SOFF 

There are no parameters associated with this command. 
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For quiek reference, all the commands you may enter from a workstation are Ksted 
alphabetically here. 



ALLOCATEA 



^¥SII=volune 




I .TOPASS^asswrdl C , WPASS^password] 



,SUE=n 



ASKA[user-id3/text' 



BASIC 



BEG^MAJEQ' 



BEGIMAjobname 



BEGWASPL, 




t ,ACCT=acctno3 [ ,BM^MB=binary- John©] [ ,CART=cartrldge-na»e3 



I,DEV= rmnn H,nLE=filenaroeK,FQRH™f©rmiaiieH,J0B=jobnaii«][,STEP^stepio3 
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Workstaton Coinnidnds 



BRKPTA I P 1 * I PR 1 £#^' 



ACCT-acctno] I ,^RT=cartrldge-nane3 



[,DEV= nnrm ]C,nLE=f nenaneJC,FORM-fornnaiie],^B-jobnaneC,ifOLD] 



BRKPTALOG 



,aJT= 



DISK 

DINET TE 



C.H0LD3 



CAHCELAjotaaw 




giAMGEAjobiaRe, 



CHANGE^SPL, 



ALL 
LOQ 
PRINT 



[,modlfier-1 ... nwdlfier-nl 
CCOPIES^rmn] 



,D¥C= 


■ f7$ 

776 

PFC 

ANY 

CLASS 1 

CLASS2 
. CLASS3 . 




. 




. 



,0¥C=AUX 



I user- Id J 



I user- Id J 
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C0MMEMTAMODULE=qnodJig 



,TYPE= r nwAile-type 



r nwdjle-type | 



,nLEHAME: 



file 
•fil 
"fil 



C ,RDPASS=passw0rd] [ ,yRPASS=password3 , VSM=voluT^Atext 



COMMECTAjobC.filenane] 



,IYPE= r nwdjie-type | 



COPYAHODULE^nodjit 



E .RDPASS^assyord] ,¥SM=voliOTeATOAMODULE==n»dul 



,nLENAME= 



file 
•fil 

"fil 



,JYP^^ I moAile-type 1 



,F1LEMAHE= 



"fill 



C «RCSZ-n3 C ,WRPASS=password3 ,VSM-volune 



.COKT,==|BJ ..»C=|nJ 



[,SlZE=n3 



,SAT- 



{«} 



ACMUMBER][,HEX]E,WAIT] 



COPYAFILEMAME^ 



file 

•fil 
"fil 



[ ,RDPASS=password] ,VSN^oU 



.^EYMO= 



(S} 



,DEVICE= f^ did 



ATuAnLENAME= 



file 

«fii 
"fil 



C jWRPASSspassword] , VSM=volune 



.KiMO= 



{S} 



,COMTIO=^ 



,KEYi = 



{?} -Mi} 

[,SlZE=n] 



intmJ pUP^^ 1 , r CHG 1) 



.MJ^- 



»scsz- 



{W} ■'""{¥} '^MS} 



[,RCSZ^n] 



,EXTEND= 



{?} 



,[BFSZ=n] 



{mi} 



.DEVICE^ 



did 



A[MUMBER][,HEX]C,yAIT] 
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C0PYAEJ0B=jobnare3 



.HOLD= 



,F1LEMAME! 



fil 

•fil 
"f!l 



iMJ-- f YES I .SKIP= r n I 



AT0A[J0B-jobnai«3 



,HOLD= 





C,ACCT-acct],«JEUE= 


' LOG 




■ 


PRINT 
PUiCH 


-1 




RDR 


M 1 


.HLEiAME^ 


fUenai» 
•fUename' • 


J 




[ "filenanw" J 






L 




J 



.QUEUES 



PRINT 
PUMCH 
RDR 



AtNUMBER][, HEX] [.WAIT] 



COPYA 



FILENAME= 



file 
'fU 

"fil 



[ , RDPASS=password] , VSN=v© i me , DEVI CE- 



{?:?.} 



,800= J YES' 1 



ATOA 



FILENAMES 



fil 
«ff| 

"fil 



C , WRPASS=passw©rcl] , VSi=v©l 



ui«, DEVICES J did \ 

1 Mre| 



,IMIT= r YES 1 , EXTEND- f III 1 



E,BFSZ=n3 



,BKnO- r YES 1 

— [m I 



■ 


,RCFM= 


FIXBL^ 
VARUNB 
VARBLK 
. UNDEF 






L 




J 



C.RCSZ-n]ACIIUMBER]C„IJEX]E,yAIT3 
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COPYADEVICE- 



ATOADEVICE= 



did 

DISKE TTE 

RDR 

did 
J DISKETTE 
PRINT 

PUMCH 



,F1LE^AME= 



fil 
'fil 
"ft I 



,VSN=V0li 



,RCFM= r 11 



|var| 



[.RCSZ^n] 



,F1LEIIAME= 



file 
'fil 
"fil 



,VSH=volumeA[NUMBER][, HEX] [.WAIT] 



DDPAceNwnand-strfng 



DEFKEYA 



r F#nn 1 , I scoranand string = 1 
I MU I I "conmand string" J 



DEFKEYA 



[ri 



DEFKEYADI SPLAY 



DELETEASPL, 



ALL 
LOG 
PRINT 

RDR 



[ ,ACCT=aectno] I , BNUHB=binary- jobno] C ,CART=cartridge-name] 



[ , DEV-nnnn] [ , R LE-f i lename] E , FORH-f ormnatne] [ , JOB= jobiame] [ ,STEP=stepio] 



DELETEAjobname[,LOG] 



DELETEAJBQ, 



[,LOG] 
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womSwoon i^oniifiafiQs 



DISPLAYMCT 



« 


PRIMT 






. EM^CH , 





t ,ACCT=acctno] [ ,CART=cartr1dge-na!ie3 



C^DEV-nnnn] [ , R LE=f ! lenOTe] [ , F0RH=fornnaTie3 [ , JOB= jobnane] [ ,STEP=stepno] 



DiSPLAYAJBQ, 



WSPLAYAJSCJobnane] 



DiSPLAYALOG 



DiSPLAYASPL 


» 


LOG 

PUNCH 
. RDR 






. 




. 



C,^CT-acetno][jCART=cartrtdge-nane] 



C ,DEV-nr.nn] [ , FI_LE=f i ienane] I ,FORM=formaTie] C , JOB-jotaaiM] [ ,STEP-stepio3 



J progran-name 1 
\ /OFFLINE J 



DLOADA f progn 

/OFFLINE 



EDTA[ initial comnand] 



EMTERAMODULE=modul 



,TYPE- 



r n»djle-type 1 



,RLENAME= 



fit 

'ffi 
.Iff I 



[ ,RDPASS=password] ,VSU=yoh 



EMTERA 



,mw~~ I u I 



,FiLEMW4E= 



fii< 

'fiU 

'•filename" 



,QUEUE=RDR 
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EMTclA 



FILEMME" 



f!l 
«fil 

"fil 



C ,R0PASS»^88wrd3 , VSi»voli«e 



.DEVICE 



■ r did 1 

1 PI«ET TE J 



EMTEEA 



RLEi^E" 




[ ^R0PASS*^s^rd] ^ VSM»voll«* 



.PE¥lffi 



' I did I 



EMTEEA 



^SE^^mjLE^^lli 






,mEMAi««« 



ffl 



t , WPASSTMiiwrdl , VSII«iv©ii^ 



BpSEiRLBMJIiEi 



f!i 
•ffl 



I , WPASS^wttMord] ,VSi«i¥oliae 



ESCmi 



OTOITE progrim»n«» 



RLE r Ctdldl, label) 1 A 



salfffl 
sC8it-fll 



iC8lt»fU« 





' RES ' 


) 




RUM 






, ¥»n _ 






' RES 






' RUi 


■ 




. Vin 





nrltf^tt) 



FREE 
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FSTATUSA[MODULE=TOodj I enarte ] 



,TYPE= f ipAile-type 1 
C,RDPASS-passHord],VSN=voliJTieA[L0NG3 



,F1LEMAME= 



file 
'fU 
"fil 



GOAjobia!w[,nn] 



MLPA 



s-no 
keyword- paraneter 



HOLD JBQ 



. [11 
H 
■ N ■ 

P 
L L J 



H0LDA]Qtaaw5 



HOLDASPL, 




PRIMT 








PUMCH 
LOG 








. RDR 





[ , ACCT=acctn©] [ ,BMUMB-binary- jobio] [ ,CART=cartn"dge-naroe] 



C ,DE¥=sr¥iin] [ , n LE=f f lenaie] [ , FORM=f orrniaiie] [ , JOB== jotaane] [ , STEP^stepno] 



HU 



LGEN 



'idC 5 acct]Cjpassword][, exec-pro] 



I J MEy- PASSWSRD^ne^- password] 



.BULLET 



IN- f MO 1 

1 ^E^ 1 



..0== ||s J 



LOGOFF 



Update A 
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MEMUA 




MEMUGEM 



PAUSEAjobnaw.nn 



r PR 1 A[functiQn-eodeH,ACCT=acctno][,8MUMB=binary-Jotoio]C,^RT-cartridge-naiK] 

tPu| 

[ ,FiLE=f i 1 enaneH . FORM=f orrmaroeH , iOB= jobname] 



PRIHTADEV1CE=A 



did 

DISKE TTE 
RDR 



,nLEMAME= 



file 
{ «fil 

'fii 



,VSM=volijne 



A[DIRECT][,NUMBER3[5HEX]t,yAIT][,FORM=forwiane] 



PRIMTA 



nLENAME- 



flie 
•f!l 

»ffl 



[ ,RDPASS=password3 .VSM^olume,DEVICE= 



{1-} 



,BKMP= f YES I 



AEDIRECT]C,IIUMBER]£,MEX]t,WAIT]C,FORM-fonniane] 



PRIMTaFILEHAME= 



"fib 



.mRo= 



|nj .COP,HS|nJ 



A[DIRECT]E,MUMBER][,HEX][,yAIT][,F 
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PRIWTAEJ0B=jobnai«3 



,QUEUE= LOG 

nmcH 

RDR 
t,HEX3E,WAIT]C,F0RM=fonmai»] 




.FILENAMES 



fill 
•f!i« 

^^ffienane" 



C,ACCT=acct3 



,COPIES= 



{I] '^'"{1} 



AWIRECTH, NUMBER] 



PRINTAMO0ULE»^»AlU 



[ .RDFASSspassKord] ,VSM^oi%jm 



[.FORM-formnanel 



- ill 



.FlLEMAMEs 



fll 

•ffl 

ssfii 



ACDIRECTH^MUMBERH.HEXJt.UAIT] 



PUMCHADEVICE- 



dld 

DISICET TE 

RDR 



.RLENAME- 



fil 



,VSM=v©ilJieACDIRECT]C,WAIT] 



PUMCHAFILEMAME- 



fiie 
"fii 



I .RDPASSspassword] , VSM^olune 



,mio^ 



{«} 



,COPIES= r n 1 

- ill 



,D^ICE= f did 



ACDIRECT]C,UAIT3 



PUNCHA 




C , RDPASSspassMord] , VSMsvo i s 



ACDIRECTJCMAIT] 



WO 
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PUNCHAEJOB-jobnane] 



,HOLD- 


■ L " 
N 






. Y . 





,nLENAME= 



fil 

'fil 

"fil 



[,ACCT=acct] 



, QUEUE = 



LOG 

PRINT 

Py^CH 

RDR 



,ALL= f YES 1 ,COPIES= f n ] ,SKIP= f n 1 



CDIRECT][,WAIT] 



PUMCHAMODULE=modul 



[ ,RDPASS=password] , VSN-volune 




,F1LEMAME= 



fil 

•fil 



AEDIRECT][,WAIT] 



REBUILD 



{ 



RECALLA r LASTAnn 

hh:niniss-hh: 



,pref ix,COM 



RECOVERAMODULE^modu I « 



,TYPE= r module- type ] 

~ is 1 

[ ,RDPASS- password ] [ ,WRPASS=password3 ,VSN=volum€ 



,nLENAME= 



fil 

«fil 

»=fil 



REMARKAtext 



RESUME 



RPAEfunct ion-code] [,ACCT==acctno3E,BNUMB=binary-jobno]C,CART=cartridge-name] 
[ , RLE^f i lename] C , FORM=fornfnanie] C , JOB=Jobname] 
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Workstation Commands 



RUN 



J ([did], label) 1 A[j 
[ (RDR, label) J 



obname] [ (new -name) ] 



:alt-f i Lename 
:(alt-filename, f RES 1 ) 
I RUN i 

vsn 



;(alt-fi lename^ 



RES 
RUN 
vsn 



, read-pass) 





' PRE 




[time] 


4. 


' dl ■ 






HIGH 

iiioR 

LOW 








■ 




L J 






. d9 . 












L 




J 



[,key"1-val-1 J „ . jkey-n==val-n] 



RVAjobname[ (new-name)] 





salt-filename 






■ PRE 




:Calt-f ilename. 


RES ) 
RUN [ 

vsn J 




' 


HIGH 
NOR 




:Calt-f ilename, 


" RES ' 
■ RUN 
vsn 




, read-pass) 























[ time] 



d1 



d9 



[,key-1=val-1 , . . . ,key-n=val-n] 
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SCA jotaaneC (new-nane) ] 



+ d1 



d9 



salt-filer 
•.Calt"fil« 



?Calt-fii< 



RES 
RUM 
vsn 

RES 

vsn 



, read-pass) 



PRE 
HIGH 

Loy J 



[,time3 



SCREEMA 



• 




1 


1 








w 

WRAP 






NOROLL 





J UPPER 1 
1 LOWER I 



,XMIT= 


■ VAR 
CHAM 






. ^LL 





.XFER-= 



CHAM 



,SPEED- 


1208 
600 






. 300 





,SPACEBAR= r DESTRUCT 



J DESTRUCT 1 ,LiMES= J H 1 



.KEYBOARD^ 



,iMTENSITY= 



MORMAL 
REVERSE 



I NOHEADER J 



.LOG= r ALL 1 A »■ 1 A msm 1 1 [. r siiiiii 1 1 [,si= r m i 

\ CCWMAMDS J I yiCSTM J \ BURST J \ PAGE J \ BOTTM J 



SETAIS, 



BULLDEF 
BULLOVR 
WLOGDEF 
WLOGOVR 



VV^] 
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SI J CCdld], label) 1 
\ CRDR, label) J 



AC jol»iM«3 C (newnare) ] 



3 


■ PRE 




C,tin«3 


+ 


■ d1 ■ 




' 


HIGH 

lis 

Loy 


> 






: 




L ' J 






[«j 





alt-fflenaie 




Calt-fiienaie, 


RES 
RUN 
vsn . 


) 




(alt-fiienane. 


■ RES 

• RUM 

_ vsn 


■ 


, read- pass) 










J 





STATUS 



TERMIMALS£,yiD] 

RESOIRCES 

JOBS 

FUMCTIONS 

VOLUMES 

LIMITS 



STOPA jobn«iej nnn 



TELLA 




'text' 



ULDA , f i I enaiK , vsn ^ S I ZEsnA 




UMLOAD 



WOCA[^fUe-prefix\]VSN=voluneACFREE]ESAT]tMIRAM]ELOMG] 
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Appendix C 
Sample Workstation 
Sessions 



C.l. Introduction 

This appendix contains sample workstation sessions that consist of the interactive 
command you would use to accomplish different system jobs. Each session includes all 
necessary commands, beginning with the LOGON command and ending with the 
LOGOFF command. They are included to give you a better understanding of how the 
various interactive commands work together. Two of the sample sessions perform 
utility tasks, or "system housekeeping" chores. Another runs a user job, while the last 
initializes the general editor and uses it to make corrections to some data in a file. 

In the sample sessions, the only messages shown are those that directly affect the 
progress of the session and any output generated by commands. 

C.2. A Session to Make Punched Card 
Copies of a Module 



1. LOGON USERA1,DEV4, SECRET, BULLETIN^MO, 

1. 11 LOGON 030 LOGON ACCEPTED 

3. VTOC VSN=PAY001 

4. 12 VTOC030 FILENAME TYPE EXT CYL %DIR %DATA %THIRD AVAIL 

5. 13 VTOC030 $VTOC HIRAM 001 001 

6. 14 VTOC030 FICACOMP SAT 001 002 

7. 15 VTOC030 CHECKWRIT SAT 001 003 

8. 16 VTOC030 PAYREP SAT 001 003 

9. 17 VTOC030 TOTAL FREE CYLINDERS 392 
1®. FST FILENAHE=CHECKWRIT,VSN=PAY001 

11. 18 FSTAT030 S - PLANTCK S - OFFCK S - DIVCK 

12. 19 FSTAT03@ S ■ RETIRCK S - REDEVCK S - VACCK 

13. TEL $Y$CON/PUT CARDS IN PUNCH PUNCHING 2 DECKS NOW' 

14. 20 PUNCH030 PUN HODULE=RETIRCIC,TYPE=S,FILENAME=CHEaCWRIT,VSN=PAY001,COPIES=2 

15. IS90 PUNCH COMMAND TERMINATED NORMALLY 

16. LOGOFF 



: 55 


90 





50 


; 40 
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100 


; 60 


90 





150 


TRACKS 000 
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Line 1 shows a log on to the ^stem with the user-id IJSERl A, the account number 
DEV4, and the password SEGEET. An execution profile is not speciified. By specifying 
BULLETIN=N05 tiie system bulletin is not displayed when the LOGON command is 
accepted. 

Line 3 shows a VTOC command requesting display of the volume table of contents 
(VTOC) of volume PAYOOl. Lines 4 through 9 show the VTOC display for volume 
PAYOOl. Of the files listed, you are interested in CHECKWRIT. Line 10 shows an 
FSTATUS command to list the modules present in the file CHECKWEIT. Notice that 
FSTATUS is abbreviated. The command executed satisfactorily because a sufficient 
portion of the command is identified to the system. Lines 11 and 12 show the 
FSTATUS display of the modules in CHECKWRIT. 

Line 13 shows a TELL command iof orming the system operator to place cards in the 
card punch so that tiie two copies ©f RETIRCK are made. Line 14 shows the PUNCH 
command, which makes tiie copies. Line 15 shows tiie message that is displayed when 
the PUNCH command has completed the two copies. You then log off the system witti 
the LOGOFF command and pick up tiie pimched cards at tiie computer site. 



C.3. A Session to Run a User Job 



1. L060M USER34,4567,ByLLETIM==N0 

2. 11 LOGOH030 LOGON ACCEPTED 

3. TEL 'MOUNT 000826' 

4. RV CW^F I LEsCUSERL IB, 0000265 

5. Dl JS.CCWPILE 

6. 12 DI030 CmPllE UOl YET SCHEDULED ■ INSUFFICIENT MAIN STORAGE 

7. DE JBQ,C»IPILE 

8. LOGOFF 



Line 1 shows a log on to the system with the user-id USER34 and the account number 
4567. No password or execution profile is entered, and the system bulletin is not 
displayed. In line 3^ the system operator should mount disk volume D00026 because in 
line 4, the RV command runs a job named COMPILE, residing in a library file named 
USERLIB, on volume D00026. On line 5, you check on the progress ©f COMPILE by 
entering a DISPLAY JS command to ©bt^ tiie status of COMPILE. Line 6 shows the 
message produced by tiie DI JS command, showing that COMPILE has not been 
scheduled due to insufficient main storage. If you are pressed for time and do not 
want to wait any longer to execute COMPILE, enter a DELETE JBQ command in line 
7 to remove COMPILE from the scheduling queue. COMPILE will not execute. In line 
8, you log off the system. 
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C.4. A Session to Use the General Editor 



1. LOGOM BILLM 

2„ EDT 

3. 1.8000 aREAD FILENAME=NE»IEHBERS,RDPASS=RDR,VSM^D00@29 

4. 1.0000 aPRIMT 1i3 

5. 1.0000 DAVID R. MAST 

6. 2.0000 km SMITH 

7. 3.0000 T. AAROM WALKER 

8. 4.0000 aCHANGE ^T.« TO 'TIMOTHY' 

9. 4.0000 aON 2 IMSERT 'MARY' 

10. 4.0000 aOELETE 1 

11. 4.0000 aPRIMT 1;3 

12. 2.0000 MARYAHM SMITH 

13. 3.0000 TIMOTHY AAROM WALKER 

14. 4.0000 aWRITE FILEMAME=NEWMEHBERS,WRPASS=LKT,VSN=D0@029,INIT=YES 

15. 4.800© aHALT 

16. LOGOFF 



Line 1 shows a log on with the user-id BILLM and no account number, password, or 
execution profile. Since you did not specify that you do not want to see the system 
bulletin, it will be displayed. In line 2, you initialize the general editor through the 
EDT command. Line 3 causes a copy of the file NEWMEMBERS to be read into the 
workspace file. In line 4, you request that lines 1 through 3 of the workspace file be 
displayed. Lines 5, 6, and 7 display lines 1 through 3 of the workspace file. In line 8, 
you begin to use the editor to make changes to the file, changing the T of T. AAEON 
WALKER to TIMOTHY. Line 9 adds MARY to ANN in Hne 2 of the workspace file, 
and line 10 deletes line 1 of the workspace file. In line 11, you display the corrections 
made, checking them to make sure they are correct. Lines 12 and 13 show the 
corrected lines. In line 14, you write a copy of the workspace file back to the original 
file. The INIT=YES parameter causes the workspace copy to overwrite the original file 
with the changes made. Line 15 terminates the general editor and, in line 16, you log 
off the system. 
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C.5. A Session to Erase Obsolete Files 



1. LOGOU ySER1i,ED06,36RACD 

2. 11 LOGO^030 LOGOM ACCEPTED 

3. STATUS VOLUMES 

4. 12 STATU030 D-REL070 D-ACTFAY D-y0RO1 

5. TEL 'MOUNT DISK VOLUME PAYMCl • 

6. 13 TELL030 -CONS-s 'VOLUME PAY«1 MOUNTED' 

7. VTOC VSy-PAYMCl 

8. 14 VTOC030 FILEMAME TYPE EXT CYL %DIR 

9. 15 VTOCi30 PAYFIC31880 MIRAM 002 M7 50 

10. 16 VTOC030 PAYeHD31880 MIRAM 001 005 35 

11. 17 VTOC030 PAYCIIO1880 HIRAM 0i1 006 47 

12. 18 VTOCi30 TOTAL FREE CYLINDERS 382 TRAKS 000 

13. ER FILEMAME-PAYFIC31880,VSI^=PAYMC1 

14. 19?ERASEa30 IS51 ERASING ENTIRE FILE, PROCEED? (Y,N) 

15. 19 ERASE030 Y 

16. 20 ERASE030 IS90 ERASE COmAMD TERMIMATED NORMALLY 

17. LOGOFF 



Line 1 shows a log on with the user-id USERIO, the aecount number ED06, and the 
password 36RACD. To find out what volumes are currently mounted on the system, 
you enter the STATUS command in line 3 with the VOLUMES parameter. Line 4 
shows the display produced by the STATUS command. Since tiie volume you want t© 
work with is not currently mounted, you send a message to the ^stem operator in line 
5 to mount tiie volume you want. In line 6^ you receive the reply that the volume is 
mounted. In line 7, you perform a VTOC command on the volume just mounted and 
discover, in lines 8 tiirough 12, that there are tiiree files on the volume. Notice tiiat 
each file name has a 5-digit number; this number is a calendar date, indicating when 
the file was created. You decide that the file PAYFIC31880 is obsolete and erase it by 
entering the ERASE command on line 13. When you enter tiie ERASE command to 
erase an entire file, you receive the message shown ©n Hne 14, This helps prevent 
accidental erasure of files. Enter Y on line 15 and tiie command is executed. Line 16 
shows the message you receive upon successful completion ©f tfie command. In line 
17, you log off. 



C4 UP-9972 Rev. 2 



Appendix D 
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for File Parameters 



Certain file parameters can be entered in a. positional format, instead of using 
ke3rwords. In a positional format, only the actual parameters are entered; keywords 
are not used to identify them. 

Parameters are identified to the system by their position in the parameter string. The 
positional parameters are separated from each other by commas, and from the 
command with which they are associated by a space. Four parameters can be entered 
in the positional format; module name, file name with read and write passwords, 
volume serial number, and module type. Table D-1 equates the positional parameters 
with their ke3rword equivalents: 



Table D-l« Positional and Keyword Parametei« 



Positional 


Keyword 


module 


MODULE=n»odu I ename 


filename 

"filename* 

"filename" 


FILEHAME= filename 
•filename' 

"f ilenane" 


readpass/wr i tepass 


RDPASS=password WRPASS=password 


voltroe 


VSN=volijne 


type 


TYPE=moduletype 
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The general format for positional file parameters is as follows: 



[nwdjlenanelj 



filenaite 

'filenane' 

"filenane" 



[ C [rea^ass] [/wrt tepass] ) ] 



jCvoiun»]j[type] 



If, in entering a command, you use both positional and keyword parameters, you must 
enter the positional parameters firsts with the kej^word parameters following the last 
positional parameter. 

The positional parameters must be entered in the order shown, or the command will 
be rejected. If a positional parameter is optional in a command and you do not use it, 
you must enter a comma in its place in the parameter string. If you do not enter a 
module name but do enter a file name and volume serial number, you must enclose 
the file name in quotation marks ("...") or enter a leading comma (comma before the 
file name). The read and write passwords must be entered in parentheses. If both are 
entered, the read password must be entered first, followed by a slash (/) and then the 
write password. If both are entered, they must both be enclosed in one set of 
parentheses. No command is entered between the file name and passwords. 

The following is an example of a positional parameter string: 

PAYJ0B1,PAYFILECSECRET),ABC466,S 

This example shows a source module (S) named PAYJOBl, residing in a file named 
PAYFILE, located on a volume with the volume serial number ABC466. The read 
password for PAYFILE is SECRET. 

Note: If the read and write passwords are the same, specifying the read password 
alone allows both read and write access to the file. 

But entering: 

PAY J0B1 , PAYF I LECSECRET/) , ABC466, S 

will not allow write access to the file, even if the write password is SECRET. 
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The following is an example of -a positional parameter string in wMch no module name 
is entered. 

"PAYROLL", ABC466 

In this example, only the file name, PAYROLL, and the volume serial number, 
ABC466, are given. Therefore, the file name is enclosed in quotation marks. Note 
also that no password is given. 

The previous example could also be written as follows: 

,PAYR0LL,ABC466 
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Function Key Summary 



Table E-1 provides a summary of the function keys used by interactive services and 
the various interactive facilities. 

Table E-1. Fynctlon Key Summary 



Software Component 



Interactive services 



General editor CEDT) 



Key 



F15 



F17 



F19 



Fl 



F2 



F3 



F4 



Function 



Informs the system you have no more data to input from 
the workstation (end of file). 



Temporarily halts the workstation display (see F19), 



Restarts workstation display after it has been 
temporarily stopped using F17 or when the screen is 
full of data. 



Suppresses any printing options associated with a 
conmand (same as F18>. 



Terminates processing of a conmand. 



Displays a screen showing the parameters on the aSET 
directive, or those that make up your EDT envirorwent. 
F3 is the same as issuing the PARAMS screen conmand. 



F5 



F6 



F12 



Displays a free- form screen through which you can 
switch to block mode for entering multiple comuands or 
data. F4 is the same as issuing the BLOCK screen 
conmand. 



Displays free-form screens, showing the EDT work-space 
file^ where you can update lines or simply view them, 
F5 is the same as issuing the ROLL screen conmand. 



Displays help screens for any EDT error messages. F6 
is the same as issuing the HELP screen comnand. 



Shows a previously displayed additional help screen 
for a specific conmand when that conroand requires a 
several help screens to fully describe it. 



continued 
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Table E"l« Function Key Summary CcontI 



Software Con|»nent 


Key 


Function 


General editor CEDT) 
(cont.) 


F13 


Displays the EOT camand menu screen and help screens 
for any of the EOT conmands (that Is^ EOT cannands^ 


iiKjdff lefS^, directives^ procetijre file ccmwtaidSs 
variables, and screen camiands). F13 is the sane as 
Issuing the PRWPT screen cannand. Fran a help screen , 
F13 also lets you see subsecpent help screens neecfed 
to fully describe the cannand. 


F14 


Returns you to the point In your E0T session where 
you originally entered a screen coinnand, F14 Is the 
sane as issuing the RESTORE screen cOTwand^ 


F15 


Recogniied as EOF Indicator. Halts an EDT session run 
In batch n»de or procfcjces an error message in 
Interactive moite. 


F18 


Sufipresses printing option associated Hith a comnaid 
Csane as F1). 


F19 


Restarts workstation display after ft has been 
tef^^rarily stopped using F17 or when the screen is 
full of data. 


Screen format services 


F1 


Returns the screen format generator to the HCF.E 
screen. Returning hm^ deletes all work done up to 
that fMlnt. 


F5 


Breakpoints the spool file to a printer. Records 
currently in the s^oled printer output are directed 
to a printer (pending an available device) » Records 
added t© the s^ol file after the breakpoint are held 
until a subse^ent breakpoint Is res^ested ©r until 
the end of the job. 


F13 


Displays a HELP screen appropriate to the step you're 
at when generating a screen format (see F145. 


F14 


Removes the HELP screen displayed by using F13; 
returns the screen format generator to the |»lnt It 
Has at before display of the HELP screen. 


F15 


Indicates end of infxit data. 



continued 



E-2 



UP-9972 Rev. 2 



Function Koy Sufnmafy 



Tabte E-L Funcioii Key Summary Icont) 



Software Ccwfxsnent 


Key 


Function 


Screen format services 
CeontJ 


F16 


Indicates Input data cannot be entered properly. 


F20 


Restores the screen to its original contents for the 
current pass if It has inadvertently been ^stroyed. 


BASIC 


F1 


Pauses or terminates execution of a BASIC progran. 
When no I/O of^ratlon Is In progress^ the system 
displays the n»ssages 

EXECUTIOM PAUSED AT LIME xxxx COMTIMUE CY,M>? 

Key In Y to continue Cresuue) execution. Key In H to 
terminate the progran. 

i If a BASIC progran is revesting output, you must 
press XMIT after pressing F1 to display the above 
message » 

i If the BASIC prograi is sending outpwt, the 
workstation screen rfwst be full of data for F1 to 
be recognized. Press F19 to display the above 
message. 


F19 


See F1. 


ESCORT 


F1 


Signals the end of input and returns to master menu. 
(Used only with the structure processor.) 


F2 


Cancels display out^t. (Used only with the structure 
processor.) 


F3 


Cancels the current screen and returns to the previous 
screen. CUsed only for progrmi and tutorial nKjdes.) 


F4 


» Structure processor? atorts structure and returns 
to menu. 

® Program modes ends free -form input and returns to 
previous menu. 

■ Run- time processors terminates progran and returns 
to caller. 
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Index 



Accounting information for workstation 

sessions, 1-17 
ALLOCATE command, 4-8, B-1 
ASK command (ask questions of other 

workstation users), 3-2, B-1 
AuxiBaiy devices, freeing (UNLOAD), 2-27 



B 



Backing up programs and files, 5-14 
BASIC command, B-1 
BASIC programming language, using, 5-36 
BEGIN command (rescheduling individual 

jobs), 2-30, B-1 
BEGIN JBQ command (rescheduling all 

jobs or jobs in a particular job 

queue), 2-30, B-1 
BEGIN SPL (releasing held spooled files), 

3-35 
WKKPT command (breakpointing spooled 

files), 3-41 
BRKFT LOG command (breakpointing 

workstation log files), 3-43, B-2 



CANCEL command (canceling a job), 3-3, 

B-2 
CH SPL command (chanpng device type 

and/or the number of copies for 

spooled files), 3-38, B-2 
CHANGE command (changing the 

scheduling queue), 2-34 



COBOL editor (COBEDT), 5-30 
Commands, entering, 1-11 
Commands, workstation (See General 

workstations commands.) 
COMMENT command, 4-10, B-3 
Communicating with interactive services 

and the system, 1-1 
Connecting a workstation to a job, 2-35 
Connecting a workstation to a job 
(CONNECT), 2-35, 2-36 
Connecting local workstations to ICAM 

user programs, 1-15 
Console, System 80 

LOGOFF procedure, A-7 
LOGON procedure, A-5 
mode switching, A-7 
signing off, A-7 
COPY utility routine command, 4-11, B-3 



Data utilities 
BASIC, 5-36 

COBOL editor (COBEDT), 5-30 
DDP commands, 5-33 
distributed data processing (DDP), 5-33 
EDT commands, 5-15 
EFP commands, 5-26 
error file processor (EFP), 5-24 
ESCORT, 5-36 
general editor (EDT), 5-15 
hardware utility (HU), 5-14 
HELP fimction, 5-12 
initializing, 5-10 

interactive DUMP/RESTORE, 5-14 
RPG editor, 5-27 
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index 



DEFKEY command, 4-16,4-17,6-5 
DEFKEY DELETE command, 4-17 
DEFKEY DISPLAY command, 4-18, B-5 
DELETE command (deleting a job from a 

scheduling queue), 2-33 
DELETE SPL command (deleting spooled 

files), 3-37, B-5 
Disconnecting a workstation from a job 

(FREE command), 3-7, B-7 
DISPLAY ACT command (obtaining 

information about program-created 

spooled files), 3-28, B-6 
DISPLAY JBQ command (displaying 

contents of a job queue), 2-32 
DISPLAY JS command (obtaining job 

status information), 3-5, B-6 
DISPLAY LOG command (obtaining 

workstation log information), 

3-46, B-6 
DISPLAY SPL command (obtaining 

information about completed 

spooled files), 3-28, B-6 
Displaying the contents of a job queue 

(DISPLAY JBQ command), 2-32 
Distributed data processing (DDP) 
commands, (table) 5-33 
description, 5-33 
DMPRST routine for creating backups, 

5-14 
Downline loading of programs (DLOAD), 
2-25 



EDT commands, (table) 5-15 

EFP (error file processor) commands, 5-24, 

(table) 5-26 
ENTER command, 4-19, B-6 
ERASE command, 4-22, B-7, C-4 
Error messages 

EXECUTE facility, 2-24 

NAK (negative acknowledgement), 1-11 

prefixed, 1-11 
ESCORT interactive programming 
language, 5-36 



EXECUTE command, using, 2-19 

EXECUTE facility 

building the super-set job stream, 2-1 7 
sample super-set job stream, 2-21 
using, 2-16 



File parameter format, positional and 

keyword, (table) D-1 
Files, erasing obsolete, 4-22, C-4 
FLUSH command, 4-24, B-8 
FREE command (disconnecting a 

workstation from a job), 3-7, B-7 
FSTATUS command, 4-24 
Function key summary 

BASIC, E-3 

ESCORT, E-S 

general editor (EDT), E-1, E-2 

interactive services, E-1 

screen format services, E-2, E-3 



General editor (EDT) 
commands, 5-15 
description, 5-15 
sample session, C-3 
General workstation commands 

ASK (ask questions of other workstation 

users), 3-2, B-1 
BASIC, B-1 
BEGIN (rescheduling individual jobs), 

2-30, B-1 
BEGIN JBQ (rescheduling all jobs or 

jobs in a particular job queue), 

2-30, B-1 
CANCEL (canceling a job), 3-3, B-2 
DISPLAY JS (obtaining job status 

information), 3-4, B-7 
FREE (disconnecting a workstation from 

a job), 3-7, B-7 
GO (reactivating suspended jobs), 3-9, 

B-8 
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PAUSE (suspending job processing), 

3-8, B-9 
RESUME (resuming subsystem 

execution), 3-10, B-11 
SCREEN (altering display 

characteristics), 3-10, B-13 
STOP (terminating a job at the end of a 

job step), 3-16, B-14 
TELL (sending messages to the system 

operator), 3-17, B-14 
GO command (reactivating suspended jobs), 

3-9, B-8 



H 



HELP function, 5-12 

HELP utility routine comimaiid 

description, 4-27 

for a command, 4-29 

for a keyboard parameter, 4-30 

for a message, 4-28 
HOLD SPL command (holding spooled 
files), 3-34, B-8 



I 



ICAM 

connecting local workstations to, 1-15 
signing on to, A-3 
using, 1-1 
Information Management System (IMS), 

accessing, 1-15 
Input messages, unsolicited 
solicited, 1-13 
unsolicited, 1-14 
Interactive accounting, 1-17 
Interactive data utilities (See Data 

utilities.) 
Interactive DUMP/RESTORE hardware 

utility (HU), 5-14 
Interactive terminals 

ICAM-connected procedure table, 

(table) A-2 
ICAM-connected SIGN-OFF command 

($$SOFF), 1-15, A-7 
ICAM-connected SIGN-ON command 
($$SON), 1-15, A-5 



ICAM-connected standard terminal 

dialog, A-4 
Hstingof, A-1 

LOGOFF procedure, 1-15, A-7 
LOGON procedure, 1-6, A-5 
mode switching, A-7 



Job control streams 

building (RV command), 2-2 

filing (FILE command), 2-3 

jprocin, 2-12 

NOSCHED option, 2-12 

option statements in, 2-12 

reading (SI/SC commands), 2-12 

running (RUN/RV commands), 2-7 

SAVE option, 2-12 

super-set, 2-16,2-17 
Job queue 

changing scheduling of (CHANGE 
command), 2-34 

deleting jobs fi-om (DELETE command), 
2-33 

displaying contents of (DISPLAY JBQ 
command), 2-32 
Jobs 

connecting a workstation to a job, 2-35 

deferring (HOLD command), 2-31 

priority, 2-1 

reactivating suspended (GO command), 
3-9 

rescheduling (BEGIN command), 2-30 

running more than one at a time (super- 
set), 2-16,2-17 

running (RUN/RV commands), 2-7, C-2 

status information, obtaining, 3-5 

suspending processing of (PAUSE 
command), 3-8 



LGEN command (creating alternate 

workstation logo), 4-30, A-6, B-8 
Logging commands 

BRKPT LOG (breakpointing 

workstation log files), 3-43, B-2 
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Logging commands (cont.) 

DISPLAY LOG (obtammg workstation 
log information), 3-46, B-6 
Logo, creating alternate workstation, 4-30 
LOGOFF command, 1-15 
LOGON 

command, 1-6 

menu, 1-4 
LOGON ACCEPTED display, 1-9 



M 



Master workstation, changing, 2-37 

MENU command, 5-8 

Menu, generator, using, 5-7 

Menu processor, using, 5-8 

MENU utility routine command, 4-30, B-9 

Menus, system-supplied, 1-9 

Messages 

error, 2-24 

output, 1-12 

restoring, 1-15 

solicited input, 1-13 

unsolicited input, 1-14 
Modes, switching between on the 

workstation, 1-3 
Module, making punched card copies of, 
C-l 



N 



Notation conventions, ix 



PAUSE command (suspending job 

processing), 3-8, B-9 
PRINT command, 4-33, B-10 
PR/PU spooling commands (manually 

loading an output writer), 3-24, 

3-25, B-9 
Programs, downline loading (DLOAD), 

2-25 
PUNCH command, 4-37, B-10 
Pimched csxd copies of a module, making, 

C-l 



Reactivating a suspended job (GO 

command), 3-9 
REBUILD command, 1-15 
RECALL command, 4-40, B-11 
RECOVER command, 4-43, B-11 
REMARK command, 4-46, B-11 
REMOVE command, 4-47 
Rescheduling jobs, 2-30 
Restoring a response message from a 

workstation (REBUILD), 1-15 
RESUME command (resuming subsystem 

execution), 3-10, B-11 
RP command (manually loading an output 

writer to an auxiliaiy printer), 

3-25 
RPG II editor, 5-27 

Running jobs from a workstation, 2-7, C-2 
RUN/RV commands, 2-7 



Obsolete files, erasing, 4-22, C-4 
Option statements in job control stream 

//OPTION NOSCHED, 2-12 

//OPTION SAVE, 2-12 

using, 5-11 
Output mess^es from the workstation, 
1-12 



Scheduling queue, changing, 2-34 
SCREEN command (altering display 
characteristics), 3-10, B-13 
Screen displays 

altering characteristics, 3-10 
creating and modifying, 5-2 
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Screen format coordinator, using, 5-5 
Screen format generator, using, 5-2 
Screen format services, 5-2 
Solicited input messages from the 

workstation, 1-13 
Spooling commands 

BEGIN SPL (releasing held spooled 

files), 3-35, B-1 
BRKPT (breakpointing spooled files), 

3-41, B-2 
CH SPL (chan^ng device t5rpe and/or 
the number of copies for spooled 
files), 3-38, B-2 
DELETE SPL (deleting spooled files), 

3-37, B-5 
directories and modifiers, 3-16 
DISPLAY ACT (obtaining information 
about program-created spooled 
files), 3-28, B-6 
DISPLAY SPL (obtaining information 
about completed spooled files), 
3-28, B-6 
HOLD SPL (holding spooled files), 3-34, 

B-8 
PB/PU (manually loading an output 

writer), 3-24, B-9 
RF (manually loading an output writer 
to an auxiliary printer), 3-25, B-11 
Status of jobs, controlling and displaying, 

1-11 
STATUS utility routine command, 4-48, 

B-14 
STOP command (terminating a job at the 

end of a job step), 3-16, B-14 
Subsystem execution, resuming, 3-10 
Super-set job control stream 
building, 2-17 
sample program, 2-21 
using the EXECUTE command in, 2-19 
Suspended job, reactivating, 3-9 
Suspending job processing (PAUSE 

command), 3-8 
Switching between modes on the 

workstation, 1-3 
System- supplied menus, using, 1-9 



TELL command (sending messages to the 

system operator), 3-17, B-14 
Terminating 

job at end of job step, 3-16 

user tasks or sessions, 4-47 
Terminals (See Interactive terminals.) 



U 



Unsolicited input messages fi-om the 

workstation, 1-14 
Upline dump command for UTS 400 
terminal users (ULD), 2-28 
Utility routine commands 

ALLOCATE, 4-8, B-1 

COMMENT, 4-10, B-3 

COPY, 4-11, B-3 

DEFKEY, 4-16,4-17,8-5 

DEFKEY DELETE, 4-17 

DEFKEY DISPLAY, 4-18, B-5 

ENTER, 4-19, B-6 

ERASE, 4-22, B-7, C-4 

FLUSH, 4-24 

FSTATUS, 4-24, B-8 

HELP, 4-27, B-8 

LGEN, 4-30, B-8 

MENU, 4-30, B-9 

PRINT, 4-33, B-10 

PU'NCH, 4-37, B-10 

RECALL, 4-40, B-11 

RECOVER, 4-43, B-11 

REMARK, 4-46, B-11 

REMOVE, 4-47 

STATUS, 3-14,4-48 

VTOC, 4-57, B-14 
Utility routines 

commands, 4-8 to 4-65 

file parameters for, 4-1 

kej^word parameters for, 4-2 
UTS 400 terminal, upline dump command, 
2-28 
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VTOC utility routine command, 4-57, B-14 

w 

Workstetion 

buildingjob streams from, 2-2 
changing the master, 2-37 
commands (See General workstation 

commands.) 
connecting to a job, 2-35 
connecting to ICAM user programs, 

1-15 
disconnectingfromajob(FREE), 3-7, 

B"7 
entering commands at, 1-11 



error messages, 2-24 

initializieg, 1-4 

losing commands, 3-4 (See aim 

Losing commands.) 
lo^ngonto, 1-4 
logo, creating alternate, 4-30 
LOGOFF command, 1-15 
LOGON ACCEPTED display, 1-9 
LOGON command, 1-6 
master, 2-37 

modes, switching between, 1-3 
nmning jobs from, 2-1 
system messages, 1-12 
system mode, 1-2,1-11 
workstation mode, 1-2, 1-11 
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